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Editor’s Notes 


Editor’s Notes 


The editor’s notes for this December 1989 issue include the items of interest 
listed below. 


D In Depth Special Features: The Sun386i Administration Cookbook 

□ Hints and Tips: Sun386i YP Masters and Slaves 

□ TTie Hackers’ Comer: cleandisk 

D Configurations: updated software release level tables, effective October 
27,1989 


In Depth Special Featoes: The This month continues a three-month series of In Depth features which will 
Sun386/ Admimstration include the Sun386i Administration Cookbook. This second month includes the 

Cookbook title page, trademarks, table of contents, and chapters 1-5. 

■Hie next STB issue, Januaiy 1990, will finish this three-part series and will 
include chapters 6-8,10, appendix A (automounter), and the cookbook index. 

STB readers should note that the pagination in these In Depth features is the 
same as in the cookbook. Simply remove the cookbook pages from the 
November 1989, December 1989, and January 1990 STBs and insert them in a 
separate Sun386/ Administration Cookbook binder. The remaining STB pages 
are paginated cumulatively as reflected in the STB Cumulative Index. 


Hints and Tips This month’s hints and tips section contains an item of interest to those setting up 

Sun386i YP master and slave servers. Following the hints contained in the 
procedure allows you to avoid ypserver not responsing messages and 
f sck inconsistencies. 
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The Hackers’ Comer This month’s Hackers’ Corner contains a short script named cleandisk of 

use to those wishing to routinely delete large, forgotten files that are of no further 
use. This script allows you a convenient way to automatically free disk space. 

For those with email access and wishing an online copy of Hackers’ Corner 
code samples, please email smlstb-editor or stb-editor@sm with your request. 
Please include the program title, and the STB issue month and year with your 
request. 

Again, please note that such applications, scripts, or code are not offered as 
released Sun products, but as items of interest to enthusiasts wanting to try out 
something for themselves. They may not not work in all cases, and may not be 
compatible with future SunOS releases. Please consult your local shell script or 
programming expert regarding any application, script, or code problems. 

The seven tables showing current Sun software product release levels appear 
monthly. These tables show release levels for operating systems, 
communications products, unbundled languages, unbundled applications, 
unbundled graphics, other products, and TOPS networking products. The tables 
in this issue are updated through October 27,1989. 

Thanks. 


Configurations: Current Sun 
Software Products and Release 
Level Tables 


The STB Editor 
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IEEE Floating Point 


IEEE Floating Point and Sun This article discusses the IEEE floating point standard from the Sun FORTRAN 

FORTRAN perspective and addresses the following commonly-asked questions: 

What do the IEEE error messages mean? 

Refer to "ieee retrospective and IEEE Warning Messages," 
below. 


If I get an exception, how do I find out where it occurred? 

Refer to "ieee handler and UNIX FPE Signals" and "dbx and 
IEEE," below. 

How do I find out all the exceptions that have occurred at any time in my 
program? Refer to "ieee_flags" and "ieee_retrospective 
and IEEE Warning Messages," below. 

I know that my program works correctly. How do I turn off the warning 
messages? The exceptions can be cleared using the information 
described in "ieeG_flags" below, or by calling a dummy 
ieee_retrospective, as described in "ieee_retrospective 
and IEEE Warning Messages," below. 

How can I get better performance with IEEE floating point? 

Refer to "Underflow Exceptions and Performance," below. 

Introduction to the IEEE 754 IEEE 754 standard floating point arithmetic offers the user greater control over 

Standard computation than is possible in any other type of floating point. Sun is one of 

many vendors who support this standard. The IEEE standard gives the user 
control over functions such as rounding precision and rounding direction. In 
addition, the IEEE standard allows the user to decide for himself or herself 
whether the program should abort or continue. 
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The TFF.F. 754 standard is implemented by Sun by a combination of both 
hardware and software: on Sun-3 and Sun-3x (Motorola 680X0-based) kernel 
architectures; Sun-4 and Sun-4c (SPARC-based) kernel architectures; and Sun- 
386/ (Intel 80386-based) kernel architecture. Currently, several hardware floating 
point options are provided by Sun, and all conform to the IEEE standard. 

On a Sun-3 system, the possible combinations are as follows: 

□ Motorola 68881, with or without the Weitek 1165/5 chip set floating 
point accelerator (FPA, sold separately) 

□ Motorola 68882, with or without TI 8847 floating point accelerator 
(FPA, sold separately) 

On Sim-4 systems, the following possible combinations are available: 

□ Older Sun-4 systems: Weitek 1164/5 (FPU) 

□ Newer Sun-4 systems and SPARCstations: Weitek 3170 or TI 8847 
(FPU2) 

The Sun386/ system supports Intel 80387 and optional Weitek 3167 floating 
point hardware (FPX). 

Note on the Examples Used All examples used in this article are for a Sun-4 system with a TI 8847 Floating 

this Article Point processor (FPU2), running SunFORTRAN release 1.2 and SunOS release 

4.0.3. The examples have also been run on the following systems/configurations: 

□ Sun-4AVeitek 1164/5 (FPU) 

□ Sun386/ with standard 80387 (FPX) 

□ Sun-3/68881/Weitek 1164/5 (FPA) 

□ Sun-3/Motorola 68881 

□ SPARCstation 1 (Sun-4c kemel)/Weitek 3170 or TI 8847 (FPU) 

o Sun-3 (Sun-3x kemel)/68882/Weitek 1164/5 

There are some differences for Sun-3x kernel (Motorola 68030-68882) and 
Sun386/ (Intel 80386-80387) from the rest of the machines used for exception 
handling. The differences are noted in "ieee_handler and UNIX FPE 
Signals" and "Debugging Floating Point Exceptions," below. 

To run on a Sun-3 or a Sun-3x, it is necessary to specify - f f pa or - f 6 8 8 81 
in order to get the IEEE exception handling. On Sun-4 and Sun386/ systems, this 
capability is the default. 
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IEEE Numbers 


Sun FORTRAN implements IEEE 754 with several library routines which may 
or may not access UNIX kernel trap handling routines to perform user-specified 
operations. 


The IEEE standard specifies different types of floating point numbers, single and 
double precision, sub-normal, positive and negative infinity, and NaN (Not a 
Number). 


For more information, refer to the libm_double(3f), 
libni_single( 3 f), and ieee_values ( 3 iti) online man pages. 

The following table specifies how to get a desired precision in TF.FP value. 


Desired IEEE Value 

Double Precision 

Singie Precision 

infinity 

x=d_infinity() 

r = r_infinity() 

quiet NaN 

x=d_quiet_nan() 

r = r_quiet_nan() 

signaling NaN 

X = d_signaling_nan() 

r = r_signaling_nan() 

min_normal 

X = d_min_normal() 

r = r_min_normal() 

min_subnormal 

X = d_min_subnormal() 

r = r_min_subnormal() 

max_subnormal 

X = d_max__subnormal ( ) 

r = r_max_subnormal() 

max_normal 

X = d_max_normal() 

r = r_max_normal() 


Example 1 next illustrates some common values for single precision from 
FORTRAN on a Sun-4, which are also valid for a Sun-3 and and a Sun-386/. A 
bug has been filed on the output format on the Sun-386/ for NaN, but the routines 
still work. 
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Example 1: Common Values for Single Precision 

c example program to generate IEEE special values. 
c The special values are: infinity/ quiet NaN/ signaling NaN/ 
c min subnormal / max__subnormal / min___normal / max__normal. 

c Refer to ieee__values ( 3m) and <f 77 /f 77 __floatingpoint .h> 


tinclude <f77/f77_floatingpoint.h> 
program print_ieee_values 

c the next 2 implicit statements are necessary so that the 
c f77_floatingpoint 

c pseudo-intrinsic functions are declared with the correct type 
c single precision only in this example for the sake of brevity 
implicit double precision (d) 
implicit real (r) 

real r 

r = r_infinity() 

print *, 'r = r__inf inity() : r 

write (*, 27) r 

27 format ('in hex, r = '/ Z8.8) 
r = r_quiet_nan() 

print */ 'r = r_quiet__nan () : r 

write (*/ 28) r 

28 format ('in hex, r = ', Z8.8) 
r = r_signaling_nan() 

print */ 'r = r_signaling_nan() : r 

write (*/ 29) r 

29 format ('in hex, r = ', Z8.8) 
r = r_min_subnormal () 

print */ 'r = rjnain_subnormal() : r 

write (*, 30) r 

30 format ('in hex, r = ', Z8.8) 
r = r_max__subnormal() 

print *, 'r = r_max_subno3nnal() : ', r 

write (*, 31) r 

31 format ('in hex, r = ', Z8.8) 
r = r_min_normal () 

print *, 'r = r_min_normal() : ', r 

write (*, 32) r 

32 format ('in hex, r = ', Z8.8) 
r = r_max_normal () 

print *, 'r = rjoain^subnormal () : ', r 
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write (*, 33) r 

format ('in hex, r = Z8.8) 

end 


system 191: til f.f 
f .f: 

MAIN print_ieee_values: 
system 192: a.out 
r = r_infinity() : inf 
in hex, r = 7f800000 
r = r_quiet_nan() : NaN 
in hex, r = 7fffffff 


r = r_signaling_nan() : 
in hex, r = 7f800001 

NaN 

r = r_min_subnormal() : 
in hex, r = 00000001 

1.40130E-45 

r = r_max_subnormal() : 
in hex, r = 007fffff 

1.17549E-38 

r = r_min_normal () : 
in hex, r = 00800000 

1.17549E-38 

r = r_min_subnormal() : 
in hex, r = 7f7fffff 

3.40282E+38 


Warning: the following IEEE floating-point arithmetic exceptions 
occurred in this program and were never cleared: 

Invalid Operand; 


The subroutine ieee_f lags takes the following form: 

int ieee_flags(action,mode,in,out) 
char *action, *mode, *in, **out; 


The subroutine ieee_f lags is used for two classes of functions, as follows: 

□ To control precision, rounding modes, and so on 
° To return or clear exceptions status 

There are four types of actions: 'get', 'set', 'clear', and 
'clearall'. 'set' and 'clearall' are primarily used to control 
precision, rounding modes, and so on. 'get' and 'clear’ are used to get 

exceptions status, and to clear the exception status after an exception has 
occurred. 


The 'set' action can be used to set precision or rounding mode, while 
'clearall' is used to restore the default as existed before the user used 
'set', 'clear', when used with the mode 'exception', clears the 
exception flags for any exceptions that have occurred up until tha t time. ' get' 

' exception' tells the user if an exception of a particular type has occurred. 
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Other combinations exist, but these are the most commonly used. 

Mode can be set to 'direction', 'precision', or 'exception', 
where ' direction' sets the direction of rounding, ' precision' sets the 
precision of an operation, and 'exception' returns the stattis or clears the 
status, depending on the action specified. Note that 'precision' affects 
only the precision of the intermediate results in extended registers on the 
Motorola 68881 and 68882, and the Intel 80387 chips. 

The ' in' parameter controls the type of exception status that is returned. 
Possible condition flags are 'inexact', 'division', 'underflow', 
'overflow', and ' invalid'. ' common' will get only ' overflow', 

'invalid' and 'division' exceptions. If '' is used for 'in', the the 
highest priority exception status will be returned. (Priority order is 
'invalid', 'overflow', 'division', 'underflow', and 
'inexact'.) 

Example 2 next uses ieee_flags to get exceptions status and to clear the 
exceptions. To control computation precision or rounding, ieee_flags 
would be called with the appropriate parameters. 
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Example 2: ieee__f lags Used to Get Status and Clear Exceptions 

Program flags 
real*4 a,b 

print ' UNDERFLOW' 
a = 2.0**(1-127) * 0.001 

call pflag 

print *, ' OVERFLOW' 
b = 1.0/a 

call pflag 

print *, 'INVALID' 
a = b/(b+1.0) 
call pflag 

print 'INEXACT' 

a=10.0 
b=3.0 
i = a/b 

call pflag 

print 'DIVISION' 

a=0.0 
a = b/a 

call pflag 

end 

subroutine pflag 

The purpose of this subroutine is to 
print out the current ieee exception 
using a 'C' wrapper around ieee_flags/ 
and to clear the exceptions using 
ieee_flags from fortran. 

In Fortran 1.3, it will not be necessary to 
call ieee_flags from 'C' in order to 
print out the exceptions. This will be 
able to be done directly from Fortran. 

print and clear ieee 
integer*4 ieee,ieee_flags 
external flags__c 
parameter (1=16) 
character *(1) out 

In Fortran 1.2 or earlier, it is necessary to call 
a "C" routine to print out exceptions from ieee_flags. 

This will not be necessary in Fortran 1.3. 

It will then be possible to call ieee_flags to get 
exceptions status just as done below to clear the ieee flags. 

ieee = flags__c('get','exception','all' ,out) 
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c 

c Clear ieee flags so no warning messages will appear 

c and so can test for new exceptions. 

ieee = ieee_f lags('clear'exception' , 'all' , out) 

return 

end 

int flags_c_(action,mode,in/Out) 

char ^action, *mode, *in, **out/ 

{ 

int i,j,ieee_flags(); 
float x; 
char *pt; 

i = ieee__flags(action,mode,in,out) ; 
printfC' i = %3i out = %s\n”, i, *out) ; 

} 


system 223: cc -c c.c 
system 224: til f.f c.o 
f .f: 

MAIN flags: 
pflag: 

system 225: a.out 

UNDERFLOW 

i = 5 out = underflow 

OVERFLOW 

i = 9 out = overflow 

INVALID 

i = 16 out = invalid 

INEXACT 

i = 1 out = inexact 

DIVISION 

i = 2 out = division 

ieee_handler and UNIX ieee_handler is a math library routine which enables the user to set up his or 

FPE Signals her own exception handler. This is where actions such as aborting execution, 

decoding of the exception trap, or getting the address of the instruction that 
caused the exception, and others can be specified. 

One of the most common uses of an exception handler is to determine the section 
of program code in which the exception occurred. For this purpose, it is 
important to realize that the UNIX signal SIGFPE must be signaled. SIGFPE 
is not signaled by default, but only when a signal handler is established for the 
exception. This is especially important when using the dbx ' catch FPE ' 
command to locate exceptions. 
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It is not useful to call ieee_f lags from within an exception handler, because 
the ieee_f lags will not reflect the status of the exception that caused the 
trap. This makes it necessary to examine the parameter "code" in the handler 
(see Example 3 next). 

Also interesting is that FPE signals are not generated by default in all cases 
unless the user sets up an exception handler of some kind. This is especially 
important when using the dbx ' catch FPE ' command to locate exceptions, 
dbx uses UNIX FPE signals to determine where an exception has occurred. 
Therefore, in most cases if one wants to use catch FPE, then a user exception 
handler must be established. 

Only one signal is generated at any one time and the highest priority signal code 
is returned to the user-defined handler in the parameter "code" (as in Example 3 
next). There are two methods of decoding the signal to determine what kind of 
exception occurred. One method is presented below. The other method, using 
the FPE signals specified in sys/system.h, can be implemented in a similar 
way, except that the decode routine must be written in C. The parameter to the 
user exception handler "code" must be tested against the values in signal. h. 

Example 3 next shows how to use an exception handler to determine the type and 
location of an exception. Please note that this example works differently on a 
Sun386(. It is necessary to put in an exit(l) call in the handler or the 
program will loop. This is due to the hardware and is not a bug. It is possible to 
catch only the first exception. Additionally, this example will not work on Sun- 
3x (Motorola 68030-68882 processor) systems. 
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Example 3: Exception Handlers to Determine Exception Type and Location 

#include <values.h> 

#include <f77/f77___floatingpoint. h> 

c Ensure that this file is a .F file so C preprocessor invoked 
c generate the 5 IEEE exceptions: 

c invalid, division by zero, overflow, underflow and inexact 

program generate__ieee_exceptions 
external handler 
integer ieeer 
double precision a,b 

c use ieee_handler to establish the function "handler" as the 
c signal handler to use whenever any floating point exception occurs 

ieeer=ieee_handler('set', 'all', handler) 

if (ieeer.ne.O) print *, 'ieee_handler cannot set "handler" ' 

c If the user does not want to trap inexact, for example, 
c then call 

c ieeer=ieee_handler('clear', 'inexact', handler) 

c if (ieeer.ne.O) print *, 'ieee_handler cannot set "handler" ' 

c This will leave "invalid", "division", "underflow" and 
c "overflow" exception handling established. 


print *, 'INVALID' 
a = log(-37.4) 

print *, ' OVERFLOW' 

b = MAXDOUBLE 
a = MAXDOUBLE 
a = a + b 

print *, 'DIVISION' 
a=0.0 
a = b/a 

print *, ' UNDERFLOW' 

b = MINDOUBLE 
a = b/2.0 

print *, 'INEXACT' 
a=10.0 
b=3.0 
a = a/b 

end 

integer function handler (sig, code, sigcontext) 
integer sig,code,sigcontext(5) 
character label*16 
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if (loc(code).eg.208) label='invalid' 
if (loc(code).eq.200) label = 'division' 
if (loc(code).eq.212) label = 'overflow' 
if (loc(code).eq.204) label = 'underflow' 
if (loc(code).eq.l96) label = 'inexact' 
write (6,77) loc(code), label, sigcontext(4) 

77 format ('ieee exception code ', i3, 

* al7, ',', ' occurred at pc ', i5 ) 
end 

# Note that this file is f.F (uppercase F) in order to use 

# the 'C' preprocessor. 

system 291: f77 f.F 

/tmp/cpp.05437.0.f: 

MAIN generate_ieee_exceptions: 
handler: 

system 292: a.out 

INVALID 


ieee exception 
OVERFLOW 

code 

208, 

invalid 

, occurred 

at 

pc 

9124 

ieee exception 
DIVISION 

code 

212, 

overflow 

, occurred 

at 

pc 

9284 

ieee exception 
UNDERFLOW 

code 

200, 

division 

, occurred 

at 

pc 

9420 

ieee exception 
INEXACT 

code 

204, 

underflow 

, occurred 

at 

pc 

9564 

ieee exception 

code 

196, 

inexact 

, occurred 

at 

pc 

9724 


ieee_ret.rospective and The following are examples of the IEEE floating point messages. 

IEEE Warning Messages 

Warning: the following IEEE floating-point arithmetic exceptions 
occur'irsd in this pi'ogi'siin and wsr© nsvGir clsared: 

Inexact; Division by Zero; Underflow; Overflow; Invalid Operand; 

ieGe_retrospective is the FORTRAN library routine that puts out these 
messages and it is by default called when a FORTRAN program exits. However, 

ieee_retrospective can be called from anywhere in the user program, 

anywhere the user wishes to see which exceptions have occurred. This may be 
more convenient than to call ieee_f lags as described in "ieee_f lags," 
above. 

What Do the Error Messages Division by zero, underflow, and overflow are exactly what they say they are. An 

inexact exception occurs whenever the result of a floating point operation cannot 
be represented exactly by a binary number, which is to say, most of the time. For 
example, 2.0 is an exact binary number, as is 0.5, but 3.0 or 1/3.0 are not. Invalid 
exceptions arise when no numerical result makes sense, as in the cases of 
infinity-infinity, infinity*0, 0/0, sqrt(-l), log(-l), and so on. These can be 
represented as a NaN (Not a Number), positive infinity, or negative infinit y 


sun 

microsystems 


December 1989 



1484 


Software Technical Bulletin issue 1989-12 


What Do the Warning Messages 
Mean? 


Warning messages are generated by the library routine 
ieee_retrospective. If the user does not wish to see the messages for one 
reason or another, then an empty subroutine such as the following can be linked 
with the user code; 

subroutine ieee_retrospective 
end 


This dummy routine will be called instead of the library routine, and the 
messages will not appear. This should only be done if the user is certain that all 
the exceptions that occur are harmless, or have been taken care of. 

The other way to get rid of the warning messages is, of course to call 
ieee_flags with 'clear', 'exceptions' as in Example 3 above. 
Add the following statement to your FORTRAN program at any location you 
want the flags to be cleared: 

ieeer=ieee_flags('clear','exception','all',out) 


Debugging Floating Point Users often need to debug a floating point exception. There are several ways to 

Exceptions nse dbx in this instance, dbx must be able to catch an FPE signal in order to 

work. It is necessary for the user to set up an exception handler in order for FPE 
signals to be generated. For performance reasons, the default situation in many 
cases is to NOT set up an exception handler. Therefore, it is necessary to set up 
an exception handler which will cause exception FPE signals to be generated and 
then dbx can catch these. This is not possible with the - f soft option on the 
Sun-3 system. 

To use dbx, one must compile the source with the -g option, issue the 
command dbx a. out. The first command to dbx should be catch FPE 
and then run. This should give the user the source line where the exception 
occurred. To continue with the program, type cont, as in example 4 next 

A second approach is to set up an exception handler which traps SIGFPE code 
(as in example 3 above), give the command ' stop in sample_handler' 
then run the code. Use ' where' to find the location of the exception. The user 
can also call abort () in the exception handler, run with dbx, then type 
' where' to see where the exception occurred. 

Note that it is only possible to catch the first exception on a Sun-386i system, 
because the hardware does not increment the program counter and as a 
consequence, the same instruction that caused the exception is re-executed. This 
causes the program to stay at the same place. 

Using example 3 above, but compiling with -g, the code shown in example 4 
next is returned. For a Sun-3 system with a floating point accelerator, it is 
necessary to compile with f77 -g -f 68881 in order to catch the exceptions 
under dbx. Please note that this example will not work a Sun-3 system with 
Sim-3x kernel architecture (Motorola 68030-68882 coprocessor). 
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Example 4: Code Returned when Compiled with -g 

system 366: f77 -g f.F 
/tmp/cpp.05587.0.f: 

MAIN generate_ieee_exceptions: 
handler: 


Example 4-1: catch FPE 

system 367: dbx a.out 
Reading symbolic information... 

Read 326 symbols 
(dbx) catch FPE 
(dbx) run 
Running: a.out 
INVALID 

signal FPE (floating point exception) in MAIN at line 19 in file "f.F" 
19 a = log(-37.4) 

(dbx) cont 
OVERFLOW 

signal FPE (floating point exception) in MAIN at line 24 in file "f.F" 
24 a = a + b 

(dbx) cont 
DIVISION 

signal FPE (floating point exception) in MAIN at line 28 in file "f.F” 
28 a = b/a 

(dbx) cont 
UNDERFLOW 

signal FPE (floating point exception) in MAIN at line 32 in file "f.F" 
32 a = b/2.0 

(dbx) cont 
INEXACT 

signal FPE (floating point exception) in MAIN at line 37 in file "f.F" 
37 a = a/b 

(dbx) cont 

program exited with 0 
(dbx) quit 


Example 4-2: Stopping in the exception handler 

system 369: dbx a.out 
Reading symbolic information... 

Read 326 symbols 
(dbx) stop in handler 
(2) stop in handler 
(dbx) run 
Running: a.out 
INVALID 

stopped in handler at line 44 in file "f.F" 

if (loc(code).eq.208) label='invalid' 

(dbx) next! 
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stopped in handler at 0x2644 
handler+0x28: cmp %o0, 208 

(dbx) cont 

ieee exception code 208, invalid , occurred at pc 9124 

OVERFLOW 

stopped in handler at line 44 in file "f.F" 

44 if (loc(code).eq.208) label='invalid' 

(dbx) nexti 

stopped in handler at 0x2644 
handler-i-0x28: cmp %o0, 208 

(dbx) cont 

ieee exception code 212, overflow , occurred at pc 9284 

DIVISION 

stopped in handler at line 44 in file "f.F" 

44 if (loc(code).eq.208) label='invalid' 

(dbx) nexti 

stopped in handler at 0x2644 
handler+0x28: cmp %o0, 208 

(dbx) cont 

ieee exception code 200, division , occurred at pc 9420 

UNDERFLOW 

stopped in handler at line 44 in file "f.F" 

44 if (loc(code).eq.208) label='invalid' 

(dbx) nexti 

stopped in handler at 0x2644 
handler+0x28; cmp %o0, 208 

(dbx) cont 

ieee exception code 204, underflow , occurred at pc 9564 

INEXACT 

stopped in handler at line 44 in file "f.F" 

44 if (loc(code).eq.208) label='invalid' 

(dbx) nexti 

stopped in handler at 0x2644 
handler+0x28: cmp %o0, 208 

(dbx) cont 

j^eee exception code 196, inexact , occurred at pc 9724 

execution completed, exit code is 0 
program exited with 0 
(dbx) quit 

Underflow Exceptions and Perfoimance is always a very important issue. With the Sim-3/Sun FPA, Sun- 

Performance 4/FPU, Sun-386//FPX, and Sun-4-SPARCstatioivpU2, it is possible to get 

increased performance from FORTRAN by calling abrupt_underf low. 
This takes advantage of what is called the "fast mode" of the Weitek and TI 
floating point co-processors in order to increase floating point computation speed 
with subnormal numbers. When abrupt_underf low is called from a 
FORTRAN program, all subnormal operands are flushed to zero from that point 
on, thereby preventing expensive recomputation and imderflow traps. 
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Note that this does not mean that subnormal results are flushed to zero, as shown 
in Example 5 next. Since this routine does not conform to the TREE floating 
point standard, another routine, gradual_underf low, is provided to return 
the floating point to normal floating point mode. These routines can be called 
from anywhere in a program, and can be called as often as is necessary. 

In order to enhance performance, it is also necessary to not establish an 
exception handler as this requires UNIX kernel overhead. Example 5 next 
demonstrates the use of this routine. The first run uses an exception handler to 
count the number of underflows; the second run disenables the exception handler. 
The performance benefit comes when subnormal operands are flushed to zero as 
in the fourth case. 
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Example 5: Using not to Establish an Exception Handler 


#include <values.h> 
#ifdef SUB 

#define VAL MINDOUBLE 
#else 

tdefine VAL 2.2e-305 
tendif 


/* MINDOUBLE is defined in /usr/include/values.h to be the 
minimum subnormal number IEEE double precision can hold - 
namely, 4.94065645841246544e“324. 

The IEEE minimum for normal numbers, double precision, is 
around e-308. So the value 2.2e-305 is a tiny number 
near the underflow threshold. */ 


program under 

common /counters/ underflow__counter 
integer ieeer, i, underflow_counter 
double precision x, y 
external underflow_handler 

underflow_counter = 0 

#ifdef ABRUPT 

call abrupt_underflow() 

#endif 


ieeer=ieee_handler('set', 'underflow', underflow_handler) 
if (ieeer.ne.O) print *, 'Could not set underflow handler' 

do 10 i= 1, 10000 
X = VAL 

y = X * 0.01d“4 
10 continue 

print *, 'underflow counter = ' , underflow_counter 

end 

integer function underflow___handler (sig, code, sigcontext) 
integer sig, code, sigcontext(5) 
common /counters/ underflow_counter 
integer underflow_counter 

underflow_counter = underflow_counter + 1 
c write (0, 77) loc(code), sigcontext(4) 

77 format ('exception # ', i3,' occurred at pc ',i5) 
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end 

# This command is used to initiate the runs below. 

echo "case 1: normal operands" 
til “O under.easel f.F 
time under.easel 

echo "case 2: normal operands, call abrupt_underflow" 
til -o under.case2 -DABRUPT f.F 
time under.case2 

echo "case 3: subnormal operands" 

til -o under.case3 -DSUB f.F 
time under.case3 

echo "case 4: subnormal operands, call abrupt_underflow" 
til -o under.case4 -DSUB -DABRUPT f.F 
time under.case4 

system 435: cmd 

case 1: normal operands 

/tmp/epp.05890.0.f: 

MAIN under: 

underf low__handler: 
underflow counter = 10000 

7.0 real 0.8 user 6.1 sys 

case 2: normal operands, call abrupt_underflow 
/tmp/epp.05897.0.f: 

MAIN under: 

underflow_handler: 
underflow counter = 10000 

7.1 real 0.8 user 6.2 sys 

case 3: subnormal operands 
/tmp/epp.05904.0.f: 

MAIN under: 

underflow_handler: 
underflow counter = 10000 

7.3 real 0.8 user 6.4 sys 

case 4 : subnormal operands, call abrupt__underf low 
/tmp/epp.05911.0.f: 

MAIN under: 

underflow_handler: 
underflow counter = 0 

0.1 real 0.0 user 0.0 sys 
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Testing Floating Point 
Hardware 


To test floating point hardware, use the following commands. For further 
information, consult the appropriate man page(s). In most cases, it necessary to 
be supemser (su) to use these commands. 

□ Sun-4 systems: 

/usr/diag/sundiag/sundiag (tests more than fpu ) 
/usr/diag/sundiag/fputest re 
/usr/diag/fpurel -v 


o Sun-3 systems: 

/usr/etc/fpa/fparel -v 
/usr/diag/sundiag/fpatest 

Additional tools in /usr/etc/f pa 


o Sim-386/ systems: 

/usr/sysex/sysex (tests more than f px) 
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STB SHORT SUBJECTS 


Applications and mmap(2) 


Applications Use Those wanting to map memory may use the mmap(2) system call in an 

application program only. Tlus call cannot be used by device drivers, since they 
use lower level kernel interfaces. 

mmapo Overview mmap() establishes a mapping between the process’s address space at a 

specified address and length to the memory object. 

The process address space is an implementation-dependent function, and a 
successful mmap () call returns the process address space as its result. A failing 
mmap() returns ‘-1’. 

For Further Information For details, see the mmap(2) system call man page, plus the following additional 

pages: 

□ fork(2) 

p getpagesize(2) 

□ munmap(2) 

p mprotect(2) 
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rloginand cmdtcx)! 


Using rlogin within 
cmdtool Windows 


cmdtool Bugs 



Customers using rlogin from a command tool window may see the below 
message just before the window disappears. 

reset tty pgrp from xxx to yyyy 


cmdtool receives the above message because the window is dying for one of 
several reasons. If you are sending escape or control-key sequences to your 
cmdtool from a .login, . eshre , or any application, the cmdtool may 
die. 

If it dies, then it always gives the above message which basically means that the 
cmdtool is no longer running in a certain pty, since it just died. 

The bugs listed below summarize problems relating to cmdtool and escape 
and control-key sequences. 

□ 1004159. You are echoing a large number of characters into a 
cmdtool without any carriage returns within the long strings. 

□ 1002445 and 1002446. Using browse, more or typing I Control-s J 
key sequence causes cmdtool to die at times with the above message. 

D 1002452. rlogin hangs especially when dbx-ing a process, and the 
user ‘kills’ the dbx process to stop it. The error messages window 
input queue overflow and window input queue 
flushed may appear. In some cases the window just dies. 

o 1003138. You cannot use esh file completion (set filec), since the 
[ESCI key is caught by the cmdtool and not passed onto the 
application. 

□ 1004196. The f Control-D sequence is not sent to the child process in the 
cmdtool, but is caught by the cmdtool. The cmdtool puts out 
spurious characters or it core dumps. 

□ 1004456. Audible or visible do not work in a cmdtool. Echoing these 
produces spurious results. 

□ 1005090. Pressing keys on the right keypad causes the cmdtool to 
die. 

□ 1005308. Type-ahead does not always work in a cmdtool, especially 
if man y characters are being sent to the cmdtool, causing it to die. 
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Preface 

The Sun386i workstation is a Sun workstation that uses the same underlying mechanisms as other 
Sun workstations. This manual points out some of the similarities that Sun386i systems share with 
other Sun systems, as well as the features that distinguish Sun386i workstations. The Sun386i Ad¬ 
ministration Cookbook contains tables and explanations grouped by functional area that provide 
high-level information about frequently performed tasks. In addition, this manual provides proce¬ 
dures for tasks such as disabling YP, creating multiple domains, and placing Sun386i features on 
nonSun386i networks, as well as explanations of file system differences, the automounter. Secure 
RPC, and how SNAP works. 

Reminders 

♦ This is an internal Sun document It is not designed for customers, but instead for Sun’s technical 
personnel so that they can better support the Sun386i product line. 

♦ Unless otherwise specified, the information contained in this book pertains to Sun386i SunOS 
4.0.2 and should be used with systems mnning the 4.0.2 release of the software. 

♦ Do not contact BOS Engineering or USAC if you have any questions or comments regarding this 
manual. Instead, mail comments to cookbook@East . Sun. Com, and address questions to the 
standard Sun internal technical support mail aliases. 

♦ Almost all of the procedures in this manual have been tested. Although we have made a good- 
faith effort to emulate real-world network environments in the lab, you may run into site-specific 
problems. Please let us know the details if you do. 

♦ The procedures and Sun386i configurations contained in this document are fully supported by 
Sun. 


Restricting Sun386i Features 

The Sun386i system was designed for less technical users and administrators. The features intro¬ 
duced to help simplify the tasks of the target audience sometimes complicate the lives of more tech¬ 
nically proficient users and administrators. However, because Sun386i software is based on the 
same SunOS software that other Sun systems use, you can restrict Sun386i-specific features to make 
the environment almost identical to that of Sun-3, Sun-4, and SPARCstation systems. SpecificaOy, 
you can: 

♦ Disable automatic installation of systems via Automatic System Installation and prevent users 
from creating their own accounts by editing the /etc/policies file on the YP master (see the 
“policies Map’’ section in Chapter 7 for details). 

♦ Install a new Sun386i system on a non-Sun386i network by choosing the option to join the net¬ 
work as a YP client, which disables configuration probing on the new system. 

♦ systems by using familiar Sun-3/4 techniques, editing files yourself instead of using 


Terminology 

Definitions of network roles are confiising, regardless of the architecture. New network roles were 
defined for Sun386i systems to help clarify these roles. 

In the following table and throughout this manual, the icons below represent different 
architectures: 

Sun-3, Sun-4, and 
SPARCstation systems 



Sun386i systems 


tx 



Network Role 

Architecture 

Definition 

Boot Server 


s 

A Sun386i YP server that answers configuration 
probing requests via the pnp daemon. Unlike 
other Sun systems, by default all Sun386i clients 
i require a server to boot (even to single-user 
mode). 

Cluster Server 


B 

A Sun386i system with a disk that has the optional 
clusters loaded and exported; clients access clus¬ 
ters from this system. 

Dataless Client 

c 

! 

1 

A system with its own disk, containing the / and 
swap partitions; relies on server for major file 
systems (such as /usr) before booting in single- 
or multi-user mode. Similar to Sun386i diskfiil 
client. 

Diskful Client 


8 

A system with a disk and a partial copy of the files 
that are bundled with SunOS; relies on an as¬ 
signed server for /usr, /usr/local, and 
/usr/cluster to boot and operate. Similar to 
Sun-3/4 dataless client. 

Diskless Client 

G 

>11 

■III 

r 

1 8 

A system without its own disk; must rely on a serv¬ 
er for /(root), /usr, and /files to boot, ac¬ 
cess applications, and store files. 

Home Directory 
Server 

@ B 

llHMl 

Any system with a disk that provides disk space 
for users’ home directories. 

Master Server 



Sun-3/4 definition - A master YP server that 
provides YP lookup and update services to other 
systems, and contains the master copies of YP 
database files. 




Sun386i definition - Same as Sun-3/4 defini¬ 
tion, except that it also provides resource alloca¬ 
tion services (IP addresses, UID/GID) to other 
systems. 

Network Client 


B 

A system with a disk and a copy of the files that 
are bundled with SunOS. Relies on a master or 
slave server to boot, and can install itself auto¬ 
matically if the YP master is a Sun386i with ASI 
enabled. A YP client with configuration probing 
enabled. 

Slave Server 

1 

i ® 

A system that provides YP lookup services to oth¬ 
er systems, and maintains copies of database 
files from the YP master server. 
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Network Role 

Architecture 

Definition 

Standalone 

a □ 

§ 1 

Sun-3/4 definition - A system with its own disk, 
containing /, /usr, and swap partitions, that 
does not need a server to boot. Can operate on 
its own or be connected to a network. 



Sun386i definition - Same as Sun-3/4 defini¬ 
tion, except that a Sun386i standalone is not con¬ 
nected to a network and is the YP master server of 
its own domain. 

YP Client 

i ^ 

Sun-3/4 definition - A system that uses YP 
maps from a YP server, and requires a YP server 
to boot. 



Sun386i definition - Same as Sun-3/4 defini¬ 
tion. Also, a network client with configuration 
probling disabled. 

Mail Server 

i s 

The system to which mail is sent for a given user. 
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1.1 Adding and Configuring Disks 

Except for cabling and hardware differences, you can install an additional Sun386i™ support¬ 
ed disk on a Sun386i system just as you would on other Sun workstations with mkf s(8) or 
newf s(8) and edits to /etc/f stab and /etc/exports. 

Because Sun386i systems do not use suninstall, you cannot use the Sun-3™, Sun-4™, or 
SPARCstation™ suninstall procedure to install a disk. However, the procedures for ins tall , 
ing a Sun386i expansion unit with a disk, shown in Sun386i System Setup & Maintenance, are 
simple and straightforward. 

For simplicity, Sun386i documentation encourages the use of just one disk partition (c), en¬ 
compassing the entire disk, for extra disks added to Sun386i systems. This partition and addi¬ 
tional partitions are mounted on /f ilesn, a Sun386i-specific partition where n represents 
the order in which the disk was added (most of the system disk is /files, the first additional 
disk is /f ilesl, and so on). As an alternative, you can set up multiple partitions on a single 
disk, or choose not to use the /f ilesn naming convention. 

If you add a second disk to a Sun386i system and you plan to routinely boot from the system 
disk, run newf s (8) on the additional disk to overwrite any system software that might be there. 
Sun386i SNAP Administration (June 1989 edition) provides details. 

^ Exporting — If you are exporting the file system(s) on an additional disk, it’s recom¬ 
mended that you establish a symbolic link from /export to the appropriate /f ilesn 
partition(s) and export that link, rather than exporting the partition directly. This is be¬ 
cause Sun386i system disks are shipped with the three partitions /, /usr, and /files, 
with all extra space in /files, /export is a directory, not a file system, so using sym¬ 
bolic links prevents /export from ftlling up the root file system. Using /export also 
takes advantage of the fact that symbolic links are followed at mount time; it is the file to 
which the symbolic link resolves that is actually mounted. Chapter 9 provides more in¬ 
formation. 

SCSI device numbers — In the Sun386i system unit, the default SCSI disk unit number 
is 2 (sd2). In the expansion unit, the default disk unit number is 0 (sdO), the same de¬ 
fault as for Sun-3/4 or SPARCstation external disks. 

Boot order — The default boot order for Sun386i systems is: 

♦ f dO 

♦ stO 

♦ sd2 

♦ sdO 

♦ ieO 

Reference: Chapter 9 of this manual (“About /export” section) 

Sun386i System Setup & Maintenance (Appendix A) 

Sun386i SNAP Administration (June 1989 edition. Chapters 1,4, Appendix A) 
Sun386i Advanced Administration (Febraary 1989 edition. Chapter 7) 

System & Network Administration (Chapter 10) 


1.2 Installing Modems 

The /etc/ttytab file works exactly as on Sun-3, Sun-4, and SPARCstation SunOS 4.0 sys- 
teiiK; you can install modems using the standard Sun-3, Sun-4 or SPARCstation procedures, 
which include editing /etc/ttytab and /etc/remote, with one exception: On Sun386i sys¬ 
tems, carrier detect is controlled by ttysof tear instead of by rebuilding the kernel. 
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Avoiding kernel rebuild — To simplify administration, Sun386i systems allow you to 
skip the traditional kernel rebuild step. Perform the following steps as root on the sys¬ 
tem that will have the modem: 

1. Add an entry for the modem to the /etci/remote file. Sun386i Advanced Admin¬ 
istration and the reniote(5) man page provide examples. 

2. Set the remote status flag in /etc/ttytab. This flag indicates that gettY(8) 
should wait for carrier detect when opening this serial port, and should set the baud 
rate specified. 

The argument to use with /usr/etc/getty in /etc/ttytab is Dbaudrate, and 
has the format: 

port "/usr/etc/getty Dbaud" dialup device_status status_fiags 
Exan^le: 

ttya "/usr/etc/getty D2400" dialup on remote 

3. Type/usr/etc/ttysof tear -n /dev/ttyport. This tells the kernel that the 
modem wUl provide the carrier detect signal, and eliminates the need to rebuild 

the kernel. 

4. Type kill -1 1 to restart the init process (effectively enabling the modem). 

If you want to ensure that the modem is recognized each time you reboot, include the 
ttysof tear command in step 3 in a /etc/rc . * file. 

remote flag — Sun386i systems support the remote status flag in /etc/ttytab, 
which instmets the serial port driver to wait for the state of carrier detect to be asserted 
before opening the serial port. 

MS-DOS — On Sun386i systems, MS-DOS® normally tries to attach the serial port 
(COMl) when you open a DOS Window. Therefore, before administering a modem or 
terminal (with or without SNAP) make siue that MS-DOS is not using the serial port. 
Check the DOS Windows™ Device menu and, if necessary, detach COMl and reboot the 
DOS Window. 

/etc/ext_ports entries — For a modem to be visible to SNAP, you must make en¬ 
tries in the /etc/ext_ports file on the Sun386i master YP server and then rebuild YP. 
SNAP determines port availability by checking /etc/ext_ports, instead of the local 
/etc/ttytab file. If a device does not have an entry in /etc/ext_ports, SNAP 
could inadvertently overwrite existing modem or terminal entries in the local 
/etc/ttytab file if a user assigns a device to a port already in use. (SDR 6206) 

/dev/cu* entries — To recognize a modem, SNAP also must find a /dev/cu* dialer 
device entry (similar to /dev/ttyd* and /dev/cuaO for dial out on Sun-3, Sun-4, and 
SPARCstation systems) that corresponds to the serial port where the modem is connect¬ 
ed. SNAP checks the name of the port used and then creates a corresponding dialer de¬ 
vice name that begins with cu instead of tty (when installing a modem, the dialer 
device name for ttya is cua). If you create a dialer device entry in /dev yourself with 
the mknod(8) command and you want SNAP to recognize the modem, the name you 
supply must adhere to this naming scheme. For instance, if you want to use SNAP to 
administer a modem connected to ttya, create a cua entry in the /dev directory, 
not a cuaO entry as stated in Sun386i Advanced Administration. 

Hayes modems only — You can use SNAP only to add Hayes™ and 
Hayes-compatible modems. 
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^ Sun386i Advanced Administration — This manual omits the ttysof tear com¬ 

mand in the procedure for installing modems. You should mn this command before 
restarting the init process, as shown in “Avoiding kernel rebuild” on the previous 
page. 

Sun386i Advanced Administration also incorrectly states that you can add only dial- 
out modems to the Sun386i AT-bus serial port. In fact, you can add either dial-in or 
dial-out modems to both the Sun386i serial port and the Sun386i AT-bus serial port. 

Hayes modems — SNAP does not enable dial-in on Hayes 2AOO or 9600 modems, 
and the directions shown in Sun386i Advanced Administration are wrong. To use ei¬ 
ther modem for dialing in, you must perform the steps shown in the “Printers, Ter¬ 
minals, and Modems” section of Administrator’s & Developer’s Notes for Sun386i 
SunOS 4.0.2. (SDRs 6256,6429) 

y Serial port access — In Sun386i SunOS™ 4.0.1, once SNAP has owned a serial port for 
a modem, file protection on the /dev/tty entry for the port is not properly reset when 
you remove the modem or disable it from SunOS access. As a result, MS-DOS cannot 
access the port. This is fixed in 4.0.2. 

Workaround for 4.0.1: To enable MS-DOS access, as superuser 

1. Disable SunOS access to the port by removing or disabling the modem with SNAP. 

If you don’t want to use SNAP, then: 

a. Edit the local /etc/ttytab so that the device_status specified with the 
/usr/etc/getty line is off. For example: 

tty "/usr/etc/getty D2400" dialup off secure remote 

b. As root, edit /etc/ext_ports on the YP master server, changing the entry for 
this modem to of f. For example: 

system_name: ttya modem off 2400 hayes 

c. Still as root on the YP master server, enter the following command: 
cd /var/yp; make 

2. Enter chmod 666 /dev/ttyport to enable MS-DOS to access the port. 

3. Reboot the system. 



Reference: Chapter 9 of this manual (“Adding a Modem Via SNAP” section) 

Chapter 10 of this manual (ttytab and ext_ports descriptions) 

Sun386i Advanced Administration (Febraary 1989 edition. Chapter 4) 

System & Network Administration (Chapter 11) 

Sun386i SNAP Administration (June 1989 edition. Chapter 3) 

On-line Sun386i SunOS 4.0.2 man pages (man_j)ages optional cluster must be 
loaded) — ttytab(5), remote (5), ext_ports (5), ttysoftcar(5) 
Administrator’s & Developer’s Notes for Sun386i SunOS 4.0.2 (for Hayes 
modem information) 
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1.3 Installing Printers 

The local printcap file, /etc/printcap, works exactly as on Sun-3, Sun-4, and 
SPARCstation systems, and you can install Sun386i printers the same as Sun-3/4 and 
SPARCstation printers. 



ypprintcap — In addition, YP on Sun386i systems support a domain-wide printcap 
file (ypprintcap) that you can use to centralize and simplify printer naming. 


Sun386i print spooling software always looks in a workstation’s /etc/printcap file before 
consulting ypprintcap, so you can use the local /etc/printcap file to override or supple¬ 
ment what’s in ypprintcap. 

If you don’t specify a printer with the Ipr(l) command, Ipr checks your printer environ¬ 
ment variable; if it is not set, then Ipr checks /etc/printcap for the default printer (Ip). 

On Sun386i systems only, Ipr then checks /etc/ypprintcap to locate the default printer. 
Also, if you don’t have a local spool directory on your Sun386i system for a particular network 
printer, Ipr creates the spool directory for you. 


y ypprintcap — Sun386i workstations ship default printer entries in 

/etc/ypprintcap. The default printer entries supplied are for printers that SNAP 
supports. See Chapter 10 for more information on ypprintcap. 

default printer — Ip is set up as the default printer in the ypprintcap file. 

MS-DOS and serial printers — On Sun386i systems, MS-DOS normally tries to attach 
the serial port (COMl) when you open a DOS Window. Therefore, before administering 
a serial printer (whether with or without SNAP), make sure that the serial port is not be¬ 
ing used by DOS. Check the DOS Windows Device menu and, if necessary, detach 
COMl and reboot the DOS Window. 

^ ypprintcap and ext_ports — For a printer to be visible to SNAP, you must make 
entries in the following files on the master YP server and then rebuild YP. These files 
are: 

♦ /etc/ypprintcap 

♦ /etc/ext_ports 

Local printer entries in an individual machine’s /etc/printcap file do not affect 
SNAP operation, but you must administer such entries by updating the file manually (as 
on a Sun-3, Sun-4, or SPARCstation system) because SNAP only manages printers that 
are available network wide. 

SNAP uses /etc/ext_ports to determine port availability. 


^ Disabling a printer with SNAP — Page 69 of the revised Sun386i SNAP Administra¬ 
tion manual is incorrect regarding the effects of disabling a printer. When you disable 
a printer with SNAP, jobs in the printer queue continue to print but SNAP disables the 
queue, preventing new requests from being printed at that printer. 

Ipc abort and disable — Pages 72 and 73 of the revised Sun386i SNAP Administra¬ 
tion manual contain incorrect statements about the Ipc command. Ipc abort 
disables printing and attempts to kill the daemon; Ipc disable disables the queue for 
all users, including superuser. 
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Reference: Chapter 9 of this manual (“Adding a Printer Through SNAP” section) 

Chapter 10 of this manual (ypprintcap and ext_ports descriptions) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 4) 

System & Network Administration (Chapter 11) 

Sun386i SNAP Administration (June 1989 edition, Chapter 3) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — ext__ports(5), ypprintcap(5) 

Avoiding Printer Overload 

To avoid overloading individual printers on large networks, assign different default printers to 
different users. You can set a user’s default printer in either of two ways: 

♦ Set the PRINTER environment variable in the user’s . login file, so that the user’s default 
printer is defined as something other than Ip. This method ensures that a user has the same 
default printer no matter where the user logs in. Additionally, the printer environment 
variable overrides the following method for altering the default printer. 

♦ Modify the entry for Ip in the local /etc/pr intcap file on the user’s workstation. This will 
override the domain-wide definition for Ip; the default printer is determined on a 
per-workstation basis. 

1.4 Installing Terminals 

The /etc/ttytab file works exactly as on Sun-3, Sun-4, and SPARCstation systems. The 
/etc/termcap file and terminfo database are identical to those on Sun-3, Sun-4, and 
SPARCstation systems, so you can manually add any terminal listed in the /etc/termcap file 
or terminfo database. On Sun386i systems, you can use SNAP to add and administer 
VT-100™ and WY-50™ terminals and compatibles. 

y local flag — The Sun386i workstation supports the local status flag in 

/etc/ttytab, which instmcts getty(8) to ignore the state of carrier detect when 
opening the serial port. For terminals, this flag should be set to local. 

MS-DOS — On Sun386i systems, MS-DOS normally tries to attach the serial port 
(COMl) when you start a DOS Window. Therefore, before administering a modem or 
terminal (whether with or without SNAP) make sure that MS-DOS is not using the serial 
port Check the DOS Windows Device menu and, if necessary, detach COMl and reboot 
the DOS Window. 

^ ext_ports — For a terminal to be visible to SNAP, you must make entries in the 

/etc/ext_ports file on the Sun386i master YP server and then rebuild YP. SNAP de¬ 
termines port availability by checking /etc/ext_ports, instead of the local 
/etc/ttytab file. If a device does not have an entry in /etc/ext_ports, SNAP 
could inadvertently overwrite existing modem or terminal entries in local 
/etc/ttytab files if a user assigns a device to a port already in use. 
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^ Port access — In Sun386i SunOS 4.0.1, once SNAP has modified a serial port for a ter¬ 
minal, file protection on the /dev/tty file for the port is not properly reset when you 
remove the terminal or disable it from SunOS access. As a result, MS-DOS cannot ac¬ 
cess the port. This is fixed in 4.0.2. 

Workaround for 4.0.1: To enable MS-DOS access, as superuser: 

1. Disable SunOS access to the port by removing or disabling the modem with SNAP. 

If you don’t want to use SNAP to disable SunOS access to the terminal, then: 

a. Edit the local /etc/ttytab so that the device__status specified with the 
/usr/etc/getty line is of f . For example: 

tty "/usr/etc/getty D2400" vtlOO off secure local 

b. As root, edit /etc/ext_ports on the YP master server, changing the entry for 
this terminal to of f . For example: 

system__name: ttya terminal off 9600 wyse-50 

c. Still as root on the YP master server, enter the following command: 
cd /var/yp; make 

2. Enter chmod 666 /dev/ttyport to enable MS-DOS to access the port. 

3. Reboot the system. 


Reference: Chapter 9 of this manual (“Adding a Terminal Through SNAP” section) 

Chapter 10 of this manual (tty tab and ext ports descriptions) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 4) 

System & Network Administration (Chapter 11), 

Sun386i SNAP Administration (June 1989 edition. Chapter 3) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — ttytab(5), ext_ports(5) 
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2.1 File System Layout 

The SunOS 4.0 file system layout differs between Sun-3, Sun-4, and SPARCstation systems and 
Sun386i systems. 

Helpful Hints 

While the new Sun386i file system layout is designed to make administrative tasks easier, there 
may be instances when you need to do things the “old way.” Here are some hints: 

Using /usr — There is no space provided for additional files on /usr, but you still can cre¬ 
ate empty directories (mount points) in /usr. Then you can mount local or remote file sys¬ 
tems on the mount points just as on other Sun systems. Alternatively, you can create symbolic 
links from /usr to other partitions on the disk where more space is available. To make /usr 
writeable so that you can create the additional mount points or symbolic links, issue this com¬ 
mand as supemser: 

mount -o remount,rw /usr 

If after adding the mount points or symbolic links you want to make /usr read-only again, re¬ 
boot the system so that it reads /etc/f stab, which specifies the /usr partition as read-only. 

Even before you add any mount points to /usr, issuing a df (1) command might show /usr 
as more than 100 percent full. This is normal—there should still be enough room for addition¬ 
al mount points or symbolic links. 

Using the automounter — At existing sites, administrators can use automounted directories 
as complements to existing NFS^^ mount points. For example, if users are accustomed to ac¬ 
cessing an NFS-mounted directory as /usr/eeng they can still do so, even if the administra¬ 
tor has also made the directory avaOable as /vol/eeng via the automounter. Newly created 
file systems can be made avaUable through /vol, so that users no longer have to do local ad¬ 
ministration (such as creating a mount point and editing f s tab or using the mount(8) com¬ 
mand) to get access to new network file systems. 

1^ /usr — The /usr partition is reserved for SunOS and is read-only. It appears more 
^ than 100 percent full on Sun386i systems. 

Automounter — Sun386i systems start the automounter for easy access to administra¬ 
tor-defined network directories (/vol), users’ home directories (/home), and export¬ 
ed file systems on other workstations (/net). As of SunOS 4.0, all Sun systems support 
the automounter, but only Sun386i systems turn it on by default. 

Optional clusters — As of Sun386i SunOS 4.0.2, new Sun386i systems are shipped with 
all the optional clusters installed on the disk. You can increase free disk space by re¬ 
moving optional Application SunOS^*^ and the Developer’s Toolkit clusters that you 
don’t need from the disk. Systems upgrading from 4.0.1 to 4.0.2 will have the same clus¬ 
ters loaded after the upgrade as before; the upgrade procedure does not load all option¬ 
al clusters. 

Additional disks — Sun386i documentation suggests that you set up additional disks 
(not the system disk) with a single partition mounted as /f ilesn. In contrast, there is 
no suggested partitioning scheme or mount point for additional disks added to Sun-3, 
Sun-4, or SPARCstation systems. 

/export — The /export directory on Sun386i systems contains symbolic links to di¬ 
rectories, not the directories themselves. This is because /export is a directory that 
resides in root (/) and doesn’t have much free space on Sun386i systems. On Sun-3, 
Sun-4, and SPARCstation systems, /export is the mount point for a disk partition. 
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^ Home directories — By convention, Sun386i home directories appear to be in 
^ /home/usemame, an automounted directory that resolves to 

/f iles/home/groupname/usemame on the user’s home directory server. Sun-3, 
Sun-4, and SPARCstation home directories are typically in the directory 
/home/servemame/usemame. You can mix these two conventions within a network 
or YP domain. See Chapter 9 for details. 

Free space — Sun386i system disks consolidate all free disk space into one partition, 
/files. Sun386i systems use symbolic links and loopback mounts, both SunOS 4.0 fea¬ 
tures, to help accomplish this while still maintaining backwards compatibility with stan¬ 
dard SunOS directories such as /tmp. 

Reference: Chapter 9 of this manual (“Inside the Automounter” and “Inside the Sun386i File 
System” sections) 

Sun386i SNAP Administration (June 1989 edition. Appendix A) 

System & Network Administration (Chapter 6) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — lof s(4S) 


2.2 Mounting Directories 

You can manually mount Sun386i directories the same as you do Sun-3, Sun-4, and 
SPARCstation directories: Create a mount point and then issue the mount(8) command. To 
make the mount permanent, edit the /etc/f stab file on the local system and then issue the 
mount - a command, just as on other Sun systems. 

On all Sun systems, symbolic links are followed at mount time, so that the file that a specified 
symbolic link resolves to is what is actually mounted. “Inside the Sun386i File System” in Chap¬ 
ter 9 details how symbolic links are used on Sun386i systems. 

2.3 Automounting Directories 

The automounter (/usr/etc/autCTnount) is a daemon that automatically mounts remote 
NFS file systems on first access. The automounter is available on SunOS 4.0 and later 
systems. 

^ Starting the automounter — On Sun386i systems, an entry in the /etc/rc. local 
^ file starts the automounter. The automounter reads the auto. master map on the YP 
master and then establishes the mount points specified (if they are not already present) 
and manages them. By default, those mount points are: 

♦ /vol, using the auto. vol automounter map (both Sun386i conventions) 

♦ /home, using the auto. home automounter map 

♦ /net, using the buUt-in -hosts automounter map 

Sun-3, Sun-4, and SPARCstation system users can start the automounter by issuing the 
automount(8) command or by adding automount commands to /etc/rc. local 
and rebooting. 

Home directories — Sun386i home directories are mounted on /hcxne/usemame, 
while Sun-3, Sun-4, and SPARCstation home directories typically are mounted on 
/home/servemame/usemame. For guidelines on reconciling these differences, see 
Chj^ter9. 
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y Mount points — All Sun systems automount directories on mount points that begin 

with /tmp_mnt. When you display automounted directories on Sun-3, Sun-4, and 
SPARCstation systems, the paths begin with /tinp_innt/autoOOOxxx. On Sun386i sys¬ 
tems, the automounter uses loopback mounts to eliminate the need to specify 
autoOOOxxx in paths. Additionally, paths of Sun386i automounted directories are ftir- 
ther simplified; typically, /tmp mnt is not displayed (for example, /home). This is be¬ 
cause the default . login file on Sun386i systems sets the adtomount_fixnames 
environment variable. 

Reference: Chapter 9 of this manual (“Inside the Sun386i File System” section) 

Appendix A of this manual, The Automounter, a USENIX ’88 paper written by 
Brent Callaghan and Tom Lyon 

Sun386i SNAP Administration (June 1989 edition. Appendix A) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 6) 

On-line Sun386i SunOS 4.0.2 man pages (man jpages optional cluster must be 
loaded) — auto. home(5), auto. vol(5), auto .master(5), automount(8) 



2.4 Exporting Directories 

You export Sun386i directories just as you do Sun-3, Sun-4, and SPARCstation directories, by 
editing the /etc/exports file and issuing the /usr/etc/exportf s command. The SunOS 
4.0 convention is that all exported directory trees have paths that begin with /export. 

If you want to export a subdirectory on any system ranning SunOS 4.0, you should do so explic¬ 
itly by including a line for it in the /etc/exports file, and making certain that none of its 
parent directories within the same file system are already exported. For example, you cannot 
export both/a/b and/a/b/c; if you do, exportfs returns an error. 

jy Symbolic links — As a Sun386i convention, all entries in /export are symbolic links 
(or subdirectories containing symbolic links) that point to the “real” location of the file 
system to be exported. For example, symbolic links that are shipped in /export on 
Sun386i systems are to home directories, directories for optional clusters that have 
been loaded, and on-line help directories. For compatibility with other Sun systems 
and to simplify file system administration, /etc/exports entries refer to symbolic 
links in /export, rather than to the real location of the local file systems. This scheme 
also prevents the /export directory from filling up. 

In contrast, on other Sun systems suninstall uses the /export directory to mount a 
disk partition. The /export partition is then used to store exported files such as 
/export/root/client_name. Sun-3, Sun-4, and SPARCstation systems support sym¬ 
bolic links in /export, but do not use them by default For more background on how 
Sun386i systems use symbolic links in /export, see Chapter 9. 

What’s exported — Also as a convention, whole fOe systems are not exported on 
Sun386i systems. This enables a finer level of control of the machines and users that can 
mount the directory. 

Reference: Chapter 9 of this manual (“About /export” section) 

Sun386i SNAP Administration (June 1989 edition. Appendix A) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapters 6,7) 

System & Network Administration (Chapter 6) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — exportfs (8), exports(5) 
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2.5 Backing Up and Restoring Files 

You can use the dump(8), restore(8), tar(l), or cpio(l) commands on Sun386i systems 
just as on Sun-3, Sun-4, and SPARCstation systems. The DOS backup, RESTORE, COPY, and 
XCOPY commands are useful for exchanging files with PCs, but their use is not recommended 
for SunOS backups since these DOS commands do not preserve certain file system informa¬ 
tion. 



bar command — In addition, the Sun386i system provides the bar(l) command, a 
backup utility that you can use from the command hne or via SNAP Backup. ”^6 bar 
conunand has the same options as tar(l), including the ability to back up individual 
files. In addition, bar offers options to compress files, follow directory symbolic links, 
get file names from a file, restore files to a new directory or to a new owner, check own¬ 
ership before overwriting archives, and stop reading after all files are restored, bar 
also handles multiple-volume backups on both 3.5-inch diskettes and quarter-inch 
tapes. See the bar(l) man page for details. 


Performing Full System Backups 

When backing up and restoring an entire system, use the dump(8) and restore(8) commands 
instead of SNAP or the bar(l) command. (Be sure to make a copy of memory-based SunOS 
that includes the restore command; see the “restore command” bug near the end of this 
section.) The bar command attenpts to restore the file /bin/bar; in the process, 

/bin/bar is truncated to zero length, which causes the bar process to core dump when it 
takes a page fault 

If you must restore a full system backup that was performed with SNAP or bar, follow these 
steps; 

1. As root, halt the system if it is still ranning by entering /etc/halt. 

2. Boot the system in single-user mode, without running the /etc/rc. boot file, by enter¬ 
ing b -bsw at the PROM monitor prompt. 

3. Mount the /usr and /files partitions by entering: 
mount -n /usr 

mount -n -o remount,rw /usr 
mount -n /files 

You must mount and then remount /usr because the first mount command reads the set¬ 
tings in /etc/f stab, where it states to mount /usr read-only. The second command 
mounts /usr as read-write. 

4. Make copies of any files that could currently be executing, so that bar doesn’t overwrite 
them during the restore process. In addition, these copy and move commands ensure 
that you will be able to reboot the system in the unlikely event that the restore does not go 
smoothly. 

cd /sbin 
mv sh sh.old 
cp sh.old sh 
mv init init.old 
cp init.old init 
cd /bin 

mv bar bar.old 
cp bar.old bar 
sync 
cd / 
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5. Insert the backup tape or diskette(s) and restore the files, as follows: 

For backups created w ith bar, but without the - Z ontion 

Enter /bin/bar.old xvfp device 

For backups created with SNAP, or with bar - z 

In this case, extra steps are required to extract /usr/ucb/compress, or the library with 
which it is dynamically linked. Note that SNAP uses /dev/rst8 or /dev/rf dOa when 
making backups. 

a. Create a tenporary fUe called /tmp/tmpf ile that contains the following lines: 

/usr/ucb/compres s 
/lib/libc.80.2.0 

b. Run bar. old to extract everything except the compress program and the C libraiy. 
/bin/bar.old xvfpXZ device /tmp/tmpf ile 

c. Run bar .old again to extract compress into the /tmp directoiy. 

/bin/bar.old xvfpSZ (fcvioe Aisr/ucb/corpress /tmp/coinpress Aisr/ucb/oonpress 

d. Run bar. old again to extract the C library into the /tmp directory. 

/bitvbar.old xvfpSZ device /lib/libc.so.2.0 /tnp/libc.so.2.0 /lib/libc.so.2.0 

e. Move the compress program and the C library back to their original locations so that 
you have the new versions of the files. 

mv /tmp/compress /usr/ucb/compress 
mv /tmp/libc.so.2.0 /lib/libc.so.2.0 

6. When the restore operation is complete, delete the following files, which you no longer 
need: 

rm /sbin/sh.old 
rm /sbin/init.old 
rm /bin/bar.old 

7. Remove the tape or last diskette from the drive. 

8. Reboot the system by typing /etc/reboot. This ensures that you’ll mn the newly re¬ 
stored versions of files such as sh and init, and that the /usr partition is mounted read¬ 
only. 

Sun386i device names — The following device names are valid for use with bar, 
epic, tar, dump, or restore on a Sun386i system: 

♦/dev/r f dOa — Sun386i high-density diskette drive; reserves the last cylinder for er¬ 
ror handling and mapping of bad sectors (remapping is not yet supported by the 
diskette driver). 

♦/dev/rf dlOa — Sun386i low-density diskette drive; also reserves the last cylinder 
for error handling and mapping of bad sectors, which is currently unsupported 
(SNAP Backup does not support this device.) 

♦/dev/rf d2a — Optional 5.25-inch diskette drive that you can purchase; reserves 
the last cylinder (must format with f df ormat - 2 command). 

♦/dev/rf dOc — Sun386i high-density diskette drive; uses all cylinders. 

♦/dev/rf dlOc — Sun386i low-density diskette drive; uses all cylinders. (SNAP Back¬ 
up does not support this device.) 

♦/dev/rf d2c — Optional 5.25-inch diskette drive that you can purchase; uses all cyl¬ 
inders (must format with fdf ormat - 2 command). 

♦/dev/rst8 — Sun386i cartridge tape drive, QIC-24 format 
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Notes about dump — On a Sun386i system, the default device that dump uses in the 
4.0.1 release is rmt8; as of 4.0.2, the default is rst.8. You must also specify the 
size of the storage media with the - s option: 

♦ Tape —2300 feet 

♦ Cartridge — 425 feet 

♦ 1.44 high-density Mbyte diskette — 1422 blocks 

Using diskettes to dump and restore can be very time-consuming; tape is a much faster 
alternative. However, if you use diskettes, you must specify -D (for diskettes) with both 
the dump and restore commands. 

Same diskette device for backup and restore — Make sure that the device name 
used to restore files from diskettes is the same one that was used to back up the files, 
regardless of which backup/restore method you use. 

SNAP Backup uses /dev/rf dOa when copying files to diskettes. Should you use the 
bar command to restore files backed up with SNAP, specify the same /dev/rf dOa 
device. 

Symbolic links — SNAP Backup uses the bar - K command (new as of Sun386i SunOS 
4.0.2). bar - K follows only symbolic hnks that are specified on the command line. 

bar archives — SNAP can read bar archives on taj^s written in QIC-24 format (with 
/dev/rst8) or 3.5-inch, high-density diskettes (written with /dev/rf dOa). SNAP 
cannot: 

♦ Read tapes or diskettes created with cpio, tar, or dump formats. 

♦ Read bar archives on low-density 3.5-inch diskettes, high-density diskettes written 
with the /dev/rf dOc device, 5.25-inch diskettes, or tapes written with devices that 
do not use QIC-24 format. 

♦ Copy flies onto diskettes that have not been formatted as shown in Sun386i System 
Setup and Maintenance, (bar, cpio, and dump all require formatted diskettes for 
backup.) 

advanced_admin cluster — To use the dump and restore commands, the optional 
advanced_admin cluster must be on the system. (The bar, tar, and cpio com¬ 
mands are shipped on every Sun386i system disk.) 

Using bar remotely — You cannot use bar or SNAP to write to devices that are not at¬ 
tached to the local machine. 

Compressing bar files — When you enter the bar command with the ■ z option, 
bar uses the /tmp directory to compress and uncompress the files. If there is not 
enough room in the /tmp directory for bar to copy the file and compress or uncom¬ 
press it, the file will be added to the bar archive uncompressed, or extracted from the 
bar archive and left in its compressed format Make sure there is enough room in /tmp 
for 1.6 times the size of the largest file to be archived or extracted. (SDR 4896) 

recursive symbolic links with bar — The bar command follows symbolic links 
when you specify the h, K, or L options. If bar tries to follow a recursive symbolic link 
(a symbolic link that resolves to a parent directory or the same file), it will eventually 
produce a segmentation fault 
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^ duplicate bar archives — The d function modifier to the bar command, to create a 
duplicate bar archive, does not work. 

Simultaneous SNAP backups — SNAP Backup does not prevent a user from schedul¬ 
ing two backups to different devices at the same time; it does not lock a user’s backup 
catalog files for exclusive access. If you schedule two backups, they both try to update 
the backup catalog files simultaneously, and data can be lost from those files. This limi¬ 
tation applies whether you are using diskette and tape drives on the same or different 
systems. 

SNAP Remove Entry feature — The Remove Entry feature in SNAP Restore changes 
the ownership of a user’s backup catalog files to root. After using this feature, manually 
change the ownership of these files: 

cd --/.backup 

chovm username Backup* 

restore command — In Sun386i SunOS 4.0.1 and 4.0.2, the restore(8) command 
is not loaded in memory-based SunOS (the two boot diskettes you use to reload software 
if your root partition has been damaged). If you have a copy of Application SunOS on 
diskettes, you should make a copy of the memory-based SunOS diskette (diskette #2) 
and place the restore command on the copy, by performing the following steps. 

1. As supemser, insert the diskette labeled “Application SunOS diskette #2’’ into the 
drive and enter: 

dd if=/dev/rfa0c of=/tmp/image bs=9k count=160 

2. Place a new, formatted diskette into the drive, and copy the image file marip in 
step 1 to the diskette: 

dd if=/tmp/image of=/dev/rfd0c bs=9k count=160 

3. The restore program is included with the optional advanced admin cluster. 
Check to see if the advanced_adinin cluster is loaded by entering load. If 
advanced admin is not listed, then add it to the system by entering 

loadc advanced_ad]nin 

and inserting the diskette specified. 

4. Mount the diskette on /munixf s and copy the restore program to it by entering 
the commands below, exactly as shown: 

mkdir /mimlxfs 

mount /dev/fdOc /munixfs 

cp -p /usr/etc/restore /munixfs/etc 

5. Enter sync and wait for the light on the front of the diskette drive to go out before 
proceeding to the next step. 

6. Unmount the diskette and delete the image file created in step 1. 
umount /munixfs 

rm /tmp/image 

7. Label the diskette “Application SunOS diskette #2 (with restore command)” or 
something similar. 

You now have a memory-based Sun386i SunOS diskette containing the restore com¬ 
mand. Should you need to restore the contents of a disk, use the diskette just created in¬ 
stead of the original diskette #2 supphed with the system. (SDR 5177) 
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Backing up/restoring complete file systems — If you use /bin/bar to restore an 
entire file system, bar attempts to extract the /bin/bar file from the media and subse¬ 
quently core dumps because it cannot resolve page faults correctly. Therefore, do not 
use bar or SNAP (which uses bar) to back up and restore an entire file system. Use 
dump and restore instead (be sure to read the previous note on the restore com¬ 
mand). If you must restore a full system backed up with SNAP or bar, perform the steps 
in the “Performing Full System Backups” section earlier in this chapter. (SDR 6185) 

Documented bar(l), tar(l), dump(8), restore(8), cpio(l) bugs — The man 
page for each of these commands describes additional bugs. 

^ SNAP backup and restore privileges — As of Sun386i SunOS 4.0.2, if you are in the 
operator group, SNAP backup and restore functions ran with root privileges (suid). 

You have full access to all local files, but access only to NFS files in file systems that were 
exported with root access, or that have read-write privUeges set for everyone. If you ^e 
not in the operator group, SNAP backup and restore functions run with your privileg¬ 
es, enabling you to back up and restore any files you can access (both NFS and local 
files). 

Using SNAP Restore remotely — As of Sun386i SunOS 4.0.1, you could not use SNAP 
to restore files across the network unless the file systems had been exported with root ac¬ 
cess, or unless everyone had write permission on the file. 

With Sun386i SunOS 4.0.2, when a user in the operator group selects files for backup 
via SNAP, backup runs as root. This means the user in the operator group has all 
privileges to back up and restore files on the local disk. However, no NFS files can be ac¬ 
cessed unless those files are readable and writeable by everyone, or those file systems 
have been exported with root access. Basically, operator backups are intended for 
saving files on local disks. 

If the user is not in the operator group, SNAP backup and restore operations will ran 
as the user who performs them, and not as root. In this case, only the files to which 
that user has read-write permissions are accessible to him or her. This is intended pri¬ 
marily for users backing up the files they own. 

Reference: Chapter 9 of this manual (“Backing Up Data Through SNAP” section) 

Sun386i SNAP Administration (June 1989 edition. Chapter 2) 

Sun386i System Setup and Maintenance (Chapter 3) 

System & Network Administration (Chapter 7) 

On-Une Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — bar(l), tar(l), cpio(l), dump(8), restore(8) 


2.6 Establishing File System Quotas 

The same quota facility is available on Sun386i, Sun-3, Sun-4, and SPARCstation systems. The 
pieconfigured kernels shipped with Sun386i systems don’t include the code for the quota facili¬ 
ty, so you must build a new kernel to use this feature. However, there is a bug that prevents 
quotas from working with the /dev/root pseudo device, so to run quotas on Sun386i systems, 
perform the steps below. 

1. Edit the /etc/f stab file, changing all /dev/root* entries to /dev/sd2*. Add the de¬ 
sired quota setting for each file system on which you want to mn quotas. 

2. Load the conf ig and disk_quotas clusters from tape or diskette. 

3. Follow the instmctions for “Configuring the Kernel” in the README file in the directory 
/sys/sun386/conf. 
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3 conf ig, disk_quotas clusters — Make sure the conf ig cluster, included with the 

Sun386i SunOS Developer’s Toolkit software, is loaded before you rebuild the kernel. 

To run the quota utilities, the disk_quotas cluster of Sun386i Application SunOS must 
also be on the system. 

# /dev/root* devices — Quota utilities don’t work with /dev/root* pseudo devices. 
Edit the /etc/f stab file as shown previously in step 1 to work around this. (SDR 4586) 

Rebuilding kernels on diskless Sun386i systems — You cannot rebuild a kernel 
on a diskless Sun386i client because a diskless client mounts its server’s directory as 
read-only. However, if a diskless client has a Sun386i file server, you can rebuild its ker¬ 
nel on the server. If the client’s file server is a Sun-3, Sun-4, or SPARCstation system, 
perform the steps in the “Rebuilding Kernels on Sun386i Diskless Systems” section of 
C3iapter 4. (SDR 4573) 

^ README file — In Sun386i SunOS 4.0.1, the readme file omitted sun386 as a value for 
machine type. This is corrected in Sun386i SunOS 4.0.2. The file also referred to the 
Sun System Manager’s Guide for further details. The correct title of this book is 
System & Network Administration. 

Reference: Chapter 4 of this manual “Rebuilding Kernels on Sun386i Diskless Systems” 
section) 

System & Network Administration (Chapter 7) 

Sun386i Developer’s Guide (Chapter 2) 
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3.1 Controlling Automatic Account Creation 



logintool — The Sun386i New User Accounts facility, a feature of the logintool 
graphical interface to logging in on Sun386i systems, lets users create their own ac¬ 
counts. Sites that need more control over their user accounts can restrict the New User 
Accounts feature on Sun386i networks. 


^ New User Accounts — By default, users can create accounts for themselves through 
the logintool New User Accounts feature. 

SNAP user accounts — Users can also create and administer user accounts with SNAP, 
since all users whose accounts were created with SNAP or New User Accounts have all 
SNAP privileges by default. 


Restricting New User Accounts 

To disable automatic account creation through New User Accounts: 

1. Become superuser on the master YP server. 

2. Edit the /etc/policies file and set the newlogin policy to restricted. 

3. Enter cd /var/yp; make 

For networks that are not running YP and networks with a non-Sun386i YP master, the New User 
Accounts feature is automatically restricted. 

Users cannot create their own accounts when New User Accounts is restricted, or the system is 
not running YP, or the YP master is not a Sun386i system. If they try to, a message is displayed 
that teUs them to contact their system administrator to obtain a user name and password. Ad¬ 
ministrators then can establish user accounts by editing password and group files. Since SNAP 
does not rely on the newlogin policy in the policies map, administrators also can use 
SNAP to create user accounts when newlogin is restricted. 

Reference: Chapter 9 of this manual (“Adding a User Through SNAP,” “Adding a User via 
New User Accounts,” “Adding a Group Through SNAP” sections) 

Sun386i SNAP Administration (June 1989 edition, Chapter 8) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 3) 

Disabling logintool 

To disable logintool and use login(l) instead (as on Sun-3, Sun-4, and SPARCstation sys¬ 
tems), perform the steps below: 

1. Log in as root to the system where you don’t want logintool to run. 

2. Edit /etc/tty tab, removing the - n, -1, and - s switches to /us r/etc/ge tty for the 
console entry, so that it looks like: 

console "/usr/etc/getty std.9600" sun on secure 

3. Reboot the system to activate the change. 


Disabling User Account Creation with SNAP 

You can also disable the ability to create and administer user accounts with SNAP, which you 
should do on Sun386i systems that are part of multiple domains or non-Sun386i networks To 
disable user account creation with SNAP: 

1. Edit the /etc/ypgroup file on the YP master, deleting any users listed with the 
accounts group (only members of this group can create and administer user accounts in 
SNAP). The accounts entry should look like: 

accounts:*:11: 

2. Remake the YP maps by entering cd /var/yp; make 
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Reference: Sun386i Advanced Administration (February 1989 edition. Chapter 3) 

Sun386i SNAP Administration (June 1989 edition. Chapter 5) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — group(5), login( 1), logintool(8), getty(l), policies(5) 


3.2 Controlling Root Logins 

Sun386i systems use the same mechanisms as other SunOS 4.0 systems to control root access. 

On Sun386i systems, the defaults (any of which you can easily change) are as follows: 

Root password — The root password, as shipped, is the host ID. 

Console login — You can log in to the console as root since the console entry in 
/etc/ttytab has the secure flag set. 

Single-user mode — No root password is required to enter single-user mode since the 
console entry in /etc/ttytab has the secure flag set 

Teiminal login — You cannot remotely log in or log in from a terminal as root; you 
must first log in as yourself and then use the su(l) command to become root. This is be¬ 
cause the secure flag is not set for the tty entries in /etc/ttytab. This substantially 
increases security and lets you track who accesses root privUeges. 

Changing the Defaults 

You can change the root password by using the passwd root command as supemser, when 
the system is mnning in multi-user mode. If you change roofs password in single-user mode, 
passwd(l) cannot re-encrypt roofs secret key in the /etc/. rootkey file. After the system 
enters multi-user mode, you can use the keyserv - n command to change the 
/etc/. rootkey file. Then reboot the system. 

Additionally, you can remove the root password entirely by editing /etc/pa sswd. If you lat¬ 
er add a new password, you might have a problem with secure RPCs, so, in single-user mode, 
you should also remove any entry for root in /etc/publickey, /etc/. rootkey, and 
/etc/keystore. (“Secure RPC” in Chapter 9 contains more information.) 

Root logins are enabled or disabled in the system’s /etc/ttytab file through toe secure 
flag As shipped, toe ttytab file considers only toe console to be “secure.” Its line looks like 
this: 

console "/usr/etc/getty -n -s -1 std.9600" sun on secure 

Hie secure setting implies that toe physical location of toe console is secure, and so allows a 
user to log in to toe console as root. By default, root cannot log in via a terminal, modem, or 
remote log in on Sun386i systems, because toe word secure is missing on toe lines for toe 
tty devices. 

You can change root login policies as follows: 

♦ Controlling root login via toe secure flag — By removing toe secure flag from toe 
console entry in /etc/ttytab, you control both of toe following: 

♦ Access as root from toe console. When you remove toe secure flag, users must log 
in first as themselves and then use the su command if they need root privileges. 

♦ Root access in single-user mode. Removing toe secure flag forces a prompt for toe 
root password when a user enters single-user mode. 

♦ Restricting access to root via su(l) — Add users to toe wheel group as described by toe 
su(l) man page (this applies to all Sun systems). 
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^ secure setting — The default Sun386i /etc/ttytab file considers only the console 
to be “secure.” On other Sun systems, ttytab lists all potential login devices as 
“secure,” thus enabling root login through modems and local and remote terminals. 

Reference: Sun386i Advanced Administration (Febmary 1989 edition. Chapter 2) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — ttytab(5), su(l) 

Root Privileges in SNAP and Organizer 

To simplify network-wide security issues, root can use SNAP only for backing up and restoring 
data. The root account cannot use SNAP to administer users, groups, printers, terminals, mo¬ 
dems, or systems. To use SNAP for these tasks, log into an account which is a member of the 
appropriate administrative group (networks, accounts, operator, devices). For more 
information on these groups, see Sun386i SNAP Administration. 

root use of Organizer^” — On systems mnning Sun386i SunOS 4.0.1, root cannot 
mn the Organizer. This is fixed in Sun386i SunOS 4.0.2. 

Workaround for 4.0.1 — Use the - ROOT option to run Organizer as root. 


Reference: Sun386i SNAP Administration (June 1989 edition. Chapter 1> 


3.3 Controlling lockscreen and screenblank 


automatic screen saver — If you don’t do any work on a Sun386i system for 30 min¬ 
utes, by default the lockscreen(l) program automatically darkens the screen and dis¬ 
plays a moving image of the Sun logo. The automatic screen saver runs when you are 
logged into the system, as well as when you have logged out. 


You might want to change the default screen-saver program from lockscreen(l) to 
screenblank(l), since screenblank repaints the screen much faster than lockscreen 
does. (One drawback to screenblank is that it does not display any moving images, so it 
could appear that the system is turned off.) Alternatively, you might not want either screen¬ 
saver program to start automatically running after a certain period of inactivity. 


Using screenblank Instead of lockscreen 

1. Become supemser on the Sun386i system on which you’re c hang in g the screen-savCT 
program. 

2. Edit /etc/ttytab, removing the -1 switch from the console entry so that it looks like: 
console "/usr/etc/getty -n -s std.9600” sun on secure 

3. Reboot the system to activate the change. 

Disabling an Automatic Screen Saver 

1 . Become superuser on the Sun386i system on which you’re disabling the automatic r unning 
of either lockscreen or screenblank. 

2. Edit /etc/ttytab, removing the - s 1 switch from the console entry so that it looks like: 
console "/usr/etc/getty -n std.9600" sun on secure 

3. Reboot the system to activate the change. 
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3.4 Creating and Maintaining User and Group 
Accounts 



Sun386i YP files — Sun386i systems use several additional YP files that other Sun sys¬ 
tems lack: /etc/yppasswd, /etc/ypgroup, and /etc/ypaliases. These files use 
the same format, are edited in the same way, and produce the same YP maps (with 
some additions) as the /etc/passwd, /etc/group, and /etc/aliases files on any 
Sun YP master server. The yp* versions of these files enable the separation of local and 
network-wide administration of logins and aUases on the YP master server, and make 
changing the YP master easier. (On other Sun systems acting as a master server, it is dif¬ 
ficult to set up local logins or aliases because the YP makefile uses the “local” passwd, 
group, and aliases files to create its domain-wide YP maps). 


SNAP groups — Every group created with SNAP is similar to a user, with its own name, 
home directory (hame_server : /f iles/home/groupname/groupname), and entry 
in the /etc/yppasswd, /etc/ypgroup, and /etc/ypaliases, and 
/etc/auto . home files and their associated maps. Differences between users and 
groups are that you cannot log in with a group name (the password fails), and a group 
home directory contains only the copy_home script and the default files that are cop¬ 
ied to the home directories of users as they are add^ to the group. 


Each user account, whether created with the New User Accounts feature of logintool, SNAP, 
nr manuall y by editing the ^propriate files, is associated with one primary group, and op¬ 
tionally, with one or more secondary groups (up to a maximum of 16 on systems running 
SunOS 4.0 or later). A primary group provides defaults for new user accounts, including mem¬ 
bership in secondary groups and default . * files (such as . login and . cshrc). Both prima¬ 
ry and secondary group membership can govern users’ application permissions, file 
permissions, and the ability to perform tasks using SNAP. See Sun386i SNAP Administration 
for a more detailed description of group accounts and how to create and edit them. 

An advantage to using SNAP or New User Accounts to create user and group accounts is that 
you do not have to login as root on both the system where the home directory will reside and 
on the master YP server. Therefore, you do not need access to the root password for these sys¬ 
tems. 


Home directories — SNAP and New User Accounts use a path name containing an au- 
^ tomount mount point to specify home directory location. The home directory path for 

Sun386i system users as set up by SNAP and New User Accounts in the YP passwd map 
is /home/username, because this is where home directories are automounted. 

You cannot create home directories in /usr on Sun386i systems since /usr is more 
than 100 percent full. 

For details on the automounter and hints on maintaining home directories on networks 
containing Sun386i and Sun-3, Sun-4, or SPARCstation systems (which use a different 
convention for specifying home directories), see Chapter 9. 

Groups — The default primary group assigned to user accounts created with New User 
Accounts or SNAP is users. (However, you can use SNAP to select a different primary 
group when creating or changing an account.) 

Each user account on a network that includes systems ranning SunOS 3.x can belong to 
a maximum of eight groups. 

Defaults — New users get default environment files such as . cshrc and . login only 
from /home/groupname/def aults/*, their primary group’s home defaults directo¬ 
ry. However, you can modify these default files. 
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^ UID/GID allocation — GID and UID allocation in SNAP and New User Accounts is au¬ 
tomatic. Although within a YP domain you can control the range of UID and GID num¬ 
bers allocated by SNAP and New User Accounts (use the ugid_alloc. range file 
available with Sun386i SunOS 4.0.2 — see Chapter 10), you cannot allocate a specific 
UID or GID with these programs. 

^ Group entries — If you have manually administered the group files, make sure valid 
entries for all groups exist in the passwd, group, and auto. home YP maps by using 
the ypcat(l) command. Entries must be consistent among the three maps for SNAP 
compatibility. SNAP permits the addition of new users to a primary group only if that 
group entry exists in these files and their associated YP maps. If a group entry exists in 
/etc/yppasswd and /etc/ypgroup, but not in /etc/auto. home, you can still use 
SNAP to administer users who have this group as their primary group; however, you 
cannot add any users to this group. 

^ Existing user and group accounts —You can use SNAP to change passwords and 
group membership of accounts created on a Sun-3, Sun-4, or SPARCstation system 
only if you have manually created the accounts following the rales in Sun386i Ad¬ 
vanced Administration. 

Aliases for secondary groups — In Sun386i SunOS 4.0.1 and 4.0.2, when SNAP adds 
a user as a secondary member of a group, it does not add the user to that group’s mail 
aUas. (SDR 5622) 

Reference: Chapter 9 (“Inside the Sun386i File System,” “Inside the Automounter,” 

“Adding a User Through SNAP,” “Adding a User via New User Accounts,” 

“Adding a Group Through SNAP” sections) 

System & Network Administration (Chapter 14) 

Sun386i Advanced Administration (February 1989 edition. Chapter 3) 

Sun386i SNAP Administration (June 1989 edition. Chapter 5) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — auto. home(5), yppasswd(5), ypgroup (5), ypaliases (5) 


3.5 Disabling or Re-enabling a User Account 

The easiest way to disable or re-enable a user account is through SNAP. If you must disable an 
account using manual methods, there are some SNAP compatibility issues you should know 
about 

^ SNAP-disabled accounts — When an account is disabled by SNAP, the login-shell 

field of the passwd map is changed from /bin/csh to /usir/etc/sorry, which dis¬ 
plays an account disabled message and will also display the contents of the . sorry 
file in the user’s home directory, if that file exists. Thus, the login shell is disabled but 
the user’s password is not disabled. 
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^ Manuall y disabled accounts — To alter an account manually so that SNAP recognizes 
^ it as disabled, change the user’s login shell in /etc/yppasswd to /usr/etc/sorry. 
Do not follow the SunOS convention of adding an asterisk (*) to the password field. 

Here is an example of an account that is disabled in the pas swd map: 

dwu: dDTITpiJWA4DWM: 101:101: Dr. Wu: /home/dwu; /usr/etc/sorry 

If there is an asterisk in the password field, then SNAP will not be able to change a user’s 
password because the encryption of the password entered by the user will not match the 
encrypted password in /etc/yppasswd. The passwd(l) and login(l) commands 
work similarly in this respect 

If you re-enable the user account through SNAP, the user will be given the default login 
shell for his or her primary group (this is normally /bin/csh). 

Reference: Chapter 10 of this manual (yppa s swd description) 

Sun386i Advanced Administration (Febraary 1989 edition. Chapter 3) 


3.6 Changing Passwords 

You can change user passwords on Sun386i systems the same as on other Sun systems, by issu¬ 
ing the passwd(l) command on the local system. 



yppasswd file — Sun386i YP masters use the file /etc/yppasswd instead of 
/etc/pas swd to keep track of all passwords on the network. The presence of the 
yppasswd file lets you keep a local user account, with its password in /etc/passwd, 
on the YP master. Thus, the YP master can be more like any other system on the net¬ 
work, with YP files separate from local files. These yp* files also make it easier to switch 
YP masters, as described in Sun386i Advanced Administration. 


The YP passwd map is based on the /etc/yppasswd file, so when you edit 
/etc/yppasswd on Sun386i systems, the passwd map is updated when you remake 
the YP maps. This is the same YP map used on Sun-3/4, and SPARCstation systems. 


T\ rhanging passwords — When you use passwd(l) to change a password on Sun386i 
^ systems, the passwd command looks in the local / etc/passwd file and changes the 

password there, if it finds it. If /etc/passwd does not contain an entry for you, but the 
file does contain the line +: : 0:0: : :, then passwd invokes yppasswd(l), which 
looks for your entry in /etc/yppasswd on the YP master and changes the entry if it is 
there. The YP password daemon, yppasswdd(8C), then updates the passwd YP map. 

(On Sun-3, Sun-4, and SPARCstation systems: 

♦ passwd does not invoke yppasswd; to change YP password information on systems 
other than Sun386i systems, you must enter the yppasswd command. 

♦ The file used to make the YP passwd map is /etc/passwd on Sun-3, Sun-4, and 
SPARCstation TTP masters as opposed to the /etc/yppasswd file on Sun386i YP 
masters.) 


^ passwd map — SNAP never uses the local /etc/passwd file, only the YP passwd 
map. 

▲ publickey.byname map — If a user has an entry in the publickey. byname YP map 
for use with Secure RPC, and if his password cannot successfully decrypt the private key, 
he will get decryption messages when logging in. 
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Reference: Chapter 10 of this manual (yppasswd description) 

Sun386i Advanced Administration (Febraary 1989 edition, Chapters 2, 8) 
System & Network Administration (Chapter 14) 


3.7 Transferring Sun386i User Defaults 

New user accounts created with SNAP or the New User Accounts feature on Sun386i systems are 
given a standard collection of default files designed to control and complement the Sun386i 
Desktop environment. When desirable, users moving from another Sun system to a Sun386i 
system can also update their environments to reflect these new defaults, using the following 
procedure: 

1. Log in to the Sun386i system using your own name. 

2. Update your default files (. cshrc, . defaults, . login, .mailrc, . orgrc, and 
. sunview) by typing update_def aults 

Follow the prompts and insfructions that appear on the screen. 

If the directory /home/users/defaults is not available to your system or you lack the 
permissions to access it, you’ll be prompted for an alternate directory. Type the following 
directory name as an alternate: 

/files/home/users/users/defaults 

(If you are on a diskless system, this alternate directory probably won’t be available to 
your system; you’U need to temporarily log in to a Sun386i system that has a disk and remn 
update_def aults.) 

3. Edit new default files, if necessary: 

If a user previously had custom versions of any of these default files (such as settings for the 
path in the . cshrc or . login file), the changes must be reapplied by editing the new 
versions that you have copied. 

The previous versions of the files, which you may want to use for comparison, are stored 
under -/filename. old. 

4. Set up a standard mail folder directory by entering: 
rakdir -/mail 

chmod 755 -/mail 
cd -/mail 

touch dead.letter old_mail personal 
touch inbox outbox trash 

5. Check mail delivery. 

Non-Sun386i YP master — If the YP master is a Sun-3, Sun-4, or SPARCstation system, 
then mail is automatically delivered to the spool directory. 

Sun386i TfP master — If the "n* master is a Sun386i system, then check the policies map 
to see if mail is being delivered to the spool directory or to your home directory, using the 
command: 

ypcat -k policies | grep mail_delivery 

Mail to spool directory — If the mail is to be delivered to your spool directory, then com¬ 
ment out the following line (by preceding it with a #) in your . login file: 

setenv MAIL ~/mail/inbox 

Mail to home directory — If mail is to be delivered to your home directory (a feature 
available on Sun386i networks), leave the line intact since it is correctly set. 

“Setting Up and Administering Mail” in Chapter 5 provides more information about mail 
delivery. 
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If a User Frequentiy Switches Machines 

Users who frequently switch between non-Sun386i and Sun386i systems may wish to edit their 
-/. sunview files to avoid starting Organizer, Help Viewer, or any other applications not cur¬ 
rently available on Sun-3, Sun-4, or SPARCstation systems. 

Also, since Sun386i systems are based on SunOS 4.0, you might want to run SunOS 4.x on 
Sun-3, Sun-4, and SPARCstation systems that you frequently access, so that the environments 
of machines more closely resemble each other. 

Alternately, you could use symbolic links that point into some architecture-specific directo¬ 
ries on the various machines you use, so that you could have different environments on differ¬ 
ent machines. 

Minimum Settings 

A sunview/wal]ci.ng_nienus — Make sure that the Defaults Editor value for the 

sunview/walking_inenus entry is set to ©nabled for this user. (The Sun386i root 
menu will not come up if this entry is incorrectly set.) 

If you cannot update your defaults, you should consider placing the following lines in your 
. login file; 

setenv DOS_CMDTOOL off Prevents DOS from starting if you si^ly 

make a typo fix)m SunOS on Sun386i systems. 

setenv AUTOMOUNT_FlXNAMES true Displays automounted directory names 

starting with the autCMnount directory name 
(for example, /home/f red is displayed on 
Sun386i systems instead of 

/tmp_mnt/home/fred). 
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4.1 Changing System Names 

You can change the name of a Sun386i diskful or diskless system using similar procedures as for 
a Sun-3, Sun-4, or SPARCstation system. These procedures are documented in Sun386i SNAP 
Administration. In addition to the steps in that manual, to change the name of a Sun-3/4 or 
SPARCstation system, or a Sun386i system that has configuration probing disabled (see 
“Sun386i Probing” in Chapter 5), you must also: 

1. Change the name of the system in the local /etc/hosts file. 

2. Change the name of the system in the /etc/rc. boot file on Sun-3/4 or SPARCstation 
systems, or in the /etc/net. conf file on Sun386i systems. 

When you rename any Sun system that’s part of a network, you should also check the /etc/sm 
and /etc/sm. bak directories on other machines on the network. If you find the old system 
names in either directory, consider replacing the old name with the new one. If you don’t, 
those machines will display warning messages from the lock manager in their console win¬ 
dows. This is because the lock manager frequently attempts to re-establish connections using 
the old system name. If you don’t replace the old name with the new one in /etc/sm or 
/etc/sm. bak, then you can just ignore the messages. 

Host and domain names — On Sun386i systems with configuration probing dis- 
^ abled, both the host name and domain name are set in /etc/net. conf. On Sun386i 
systems where configuration probing is enabled, the host name and domain name are 
determined by responses from a slave server on the network. See Chapter 10 for more 
information on /etc/net. conf. 

By comparison, on Sun-3, Sun-4, and SPARCstation systems, the host name is set in 
/etc/rc. boot and the domain name is set in /etc/rc. local. 

Ipi System name changes — SNAP does not provide the ability to change system names, 
but will support administration of any system with a new name if you follow the proce¬ 
dures in Chapter 8 of Sun386i SNAP Administration (June 1989 edition). 

Reference: Chapter 10 of this manual (net. conf and hosts descriptions) 

Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

System & Network Administration (Chapter 12) 


4.2 Enabling and Disabling Kernel Features 

The Sun386i kernel is preconfiguied on the Sun386i system disk. The Sun386i kernel includes 
all of the required portions of the SunOS kernel, as well as the optional features most often 
used. The optional features not included in the Sun386i preconfigured kernel are those that are 
commented out in the SDST386 file (for diskful systems) and the DL386 file (for diskless sys¬ 
tems), both in the /sys/sun386/conf directory. 

You can add or disable features listed in either the SDST386 orDL386 file by reconfiguring 
the kernel. Reconfiguring a Sun386i kernel is similar to reconfiguring any other Sun kernel — 
you modify a copy of one of the kernel files provided in /sys/sun386/conf. To reconfigure 
a Sun386i kernel: 

1. Load the optional base_devel and conf ig clusters, included with the Sun386i SunOS 
Developer’s Toolkit software. 

2. Follow the instructions in the readme file in the directory /sys/sun3 86/conf. 
Rebuilding Kernels on Sun386i Diskless Systems 

Because the diskless client mounts the server’s /export/cluster/sun3 86. sunos4.0.2 
directory as read-only, you cannot build a kernel on a diskless Sun386i system. However, if a 
diskless client has a Sun386i system as its file server, you can build the diskless client’s kernel 
on the file server. 
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If a diskless client does not have a Sun386i system as its file server or you want to rebuild the ker¬ 
nel on the diskless machine, you can use the following procedure to build the client’s kernel. 

You also can use this procedure if the file server is a Sun386i system. 

A Perfonning this procedure gives the diskless client the ability to write in the file server’s 
/export partition. 

1. Log in as root on the file server. 

2. Edit the /etc/exports file and change the /export/cluster/sun386 . sunos4.0.2 
line to: 

/export/cluster/sun386 . sunos4.0.2 •"root=client/ access =otherclients 

where client is the diskless client, and otherclients are the other diskless clients with the 
same server. 

3. Save the newly edited /etc/exports file. 

4. Enter exportfs -av 

5. Log in as root on the diskless client 

6. Edit the diskless clients’s /etc/f stab file, changing mount permissions for 
/usr/cluster from read-only to read-write. 

7. Save the newly edited /etc/f stab file. 

8. Enter umount /usr/cluster; mount /usr/cluster 

9. Now follow the steps for building kernels in the readme file in /sys/sun386/conf , using 
the DL3 8 6 file as a guide instead of the generic file shown in the directions. 

10. After the diskless client has rebooted, edit the diskless client’s /etc/f stab file, changing 
mount permissions for /usr/cluster from read-write back to read-only. 

11. Enter umount /usr/cluster; mount /usr/cluster 

12. On the server, edit /etc/exports, removing the - root=client section of the 
/export/cluster/sun386 . sunos4.0.2 line. 

13. Enter exportfs -av 

1^ Kernel sizes — The Sun386i kernel is preconfiguied. You may notice that a rebuilt ker¬ 
nel is larger than the standard vmunix file shipped with the system — even if you build 
your kernel with only the “standard” options. This is normal. 

The size difference occurs because the vmunix file built as part of the standard release 
can safely exclude all code not needed in the preconfigured kernel, whereas the object 
files provided in the conf ig cluster must contain code to accommodate every kernel 
option. 

[mI conf ig, base_devel clusters — Before you can rebuild the kernel, the conf ig and 
base devel clusters, both included with the Sun386i SunOS Developer’s Toolkit soft¬ 
ware, must be loaded. 

^ README file corrections — In Sun386i SunOS 4.0.1, the readme file in the directory 
/sys/sun386/conf referred to the Sun System Manager’s Guide for further details. 

The file now contains the correct reference, to System & Network Administration. 

The Sun386i SunOS 4.0.1 README file also omitted sun386 as a value for machine type. 
This is corrected in Sun386i SunOS 4.0.2. 

^ Kernel rebuilds on diskless clients — You cannot rebuild a kernel on a diskless 

Sun386i client because a diskless client mounts its server’s directory as read-only. How¬ 
ever, if a diskless client has a Sun386i file server, you can rebuild its kernel on the serv¬ 
er. If the client’s file server is a Sun-3/4, you can rebuild the kernel by performing the 
steps earlier in this section. (SDR 4573) 
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Reference: System & Network Administration (Chapter 9) 

On-line SunOS 4.0.2 man pages (man__pages optional cluster must be 
loaded) — conf ig(8) 


4.3 Installing Drivers 

Sun386i systems support two categories of device drivers: traditional device drivers that you 
add to a system and then rebuild the kernel to use, and drivers that you can load dynamically 
into the kernel at any time. Device drivers that are not linked into the kernel are c^led load¬ 
able drivers. You don’t have to rebuild and reboot the kernel to add loadable drivers to the 
system; instead, just use the modload(8) command, included in the Sun386i core system, to 
load the driver into a running system. 

You also can convert existing nonloadable drivers to loadable drivers by following the direc¬ 
tions in the Writing Device Drivers manual. If you are not sure whether or not a driver is load¬ 
able, see if the driver code begins with a “wrapper” module, also described in the Writing 
Device Drivers manual. 

conf ig, base_devel clusters — If you need to rebuild the kernel (because you are 
not installing a loadable driver), the conf ig and base_devel clusters, both included 
with the Sun386i SunOS Developer’s Toolkit software, must be loaded. 

^ README file — The Sun386i SunOS 4.0.1 kernel readme file referred to the Sun System 
Manager’s Guide for further details. The file now contains the correct reference, to 
System and Network Administration. 

Reference: “Enabling and Disabling Kernel Features” earlier in this chapter 
Sun386i Developer’s Guide (Chapter 8) 

Writing Device Drivers (Chapter 5) 

System & Network Administration (Chapters 9,16) 

On-line SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — conf ig(8), modload(8) 



4.4 C2 Security 

Sun386i systems fully support C2 security. However, this feature is not enabled in the prein¬ 
stalled kernel shipped with each system, so you must rebuild the kernel to get C2 security. For 
instructions on how to rebuild the kernel, see “Enabling and Disabling Kernel Features” earli¬ 
er in this chapter. 

If you enable C2 security, do not subsequently add new users via New User Accounts or SNAP, 
because these programs do not support the split password and group files required for C2 op¬ 
eration (passwd. adjunct and group. adjunct). “Controlling Automatic Account Cre¬ 
ation” in Chapter 3 describes how to disable account creation through SNAP and New User 
Accounts. 


4.5 Sun386i Boot Messages 

Boot-time messages are generated by the kernel and by /etc/rc* scripts. Sun-3, Sun-4, and 
SPARCstation systems always display these messages as they are booting, while Sun386i sys¬ 
tems let you decide whether or not boot messages should be displayed. 


Progress meter replaces messages — By default, Sun386i systems boot without 
displaying the standard SunOS boot messages; instead, a progress meter dynamically 
displays the status of the boot procedure. 
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Enabling Boot Messages 

Complete the following steps to enable display of the standard messages. 

1. Enter the PROM monitor by pressing LI-a. You can do this without logging out, since en¬ 
abling boot messages is a low-risk operation. 

2. At the > prompt, type: 

> q 494 1 

> c 

3. Redisplay the screen, if you are in SunView^*^. 

4. As superuser, edit the /etc/net. conf file on the local machine, changing the 
VERBOSE= setting to: 

VERBOSE=yes 

These new settings will remain in effect through reboots and power cycles. 

Note that the net. conf change is not strictly necessary if configuration probing is enabled, 
because this file is updated automatically at boot time. However, for the sake of simplicity it is 
usually best to cl^ange both settings as shown in the above steps. 

^ No messages — On Sun386i systems, PROM location 494 is set to 0 and VERBOSE=no; 
no messages appear. 

Reference: Chapter 5 of this manual (“Sun386i Probing” section) 

Chapter 9 of this manual (“Booting a Network Client” section) 

Chapter 10 of this manual (net. conf description) 

PROM User’s Manual (Chapter 18) 


Kernel Messages 



Improved kernel error messages — The Sun386i system logging daemon, 
syslogd, translates some of the cryptic error and warning messages generated by the 
kernel into solution-oriented, nontechnical messages. For example: 


♦ Ethernet jammed is displayed as Network traffic overflow 

♦ no carrier is displayed as Problem with network connection. Check 
cables and transceivers. 


On Sun386i systems, syslogd uses the /etc/In and /etc/Out files when translating mes¬ 
sages. When it intercepts a string, sys logd looks for that string in the /etc/ln file. If the 
string is there, syslogd uses an index to find the string’s translation in /etc/Out, and then 
generates the translated message. If the intercepted string is not in /etc/ln, or if either 
/etc/ln or /etc/Out is not found, syslogd generates the standard, unaltered message. 

To rewrite kernel messages yourself, see the Sun386i Developer’s Guide. 

To disable translation, delete or rename /etc/ln or /etc/Out. 

Reference: Sun386i Developer’s Guide (Chapter 6) 
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4.6 Four Megabyte Processes and Stack Limits 

Many Sun386i utilities in /etc, /usr/etc, /usr/bin, and /usr/ucb are 4-Mbyte process¬ 
es. This means that these processes have a combined limit of 4 Mbytes for text, data, and stack 
size. This limit helps improve system performance, particularly on 4-Mbyte systems, because 
4-Mbyte processes use only one page table for mapping their address space. (On Sun-3, 

Sun-4, and SPARCstation systems, 4-Mbyte processes are not implemented.) 

Because a child process inherits its stack limit from its parent, if you change the stack limit of a 
shell such that there is no room to map text, data, bss, and shared libraries, the 4 Mbyte pro¬ 
cess will be unable to run from that shell. When this happens, you will see the following mes¬ 
sage: 

crtO: ininap of Id.so failed. 

To avoid this problem with a shell set to a stack size limit that is too large, use the unset4(8) 
command to change any such program you need to run, so that the program is no longer a 4- 
Mbyte process. For example, to change uucp, become superuser and enter the following 
commands: 

1. mount -o remount,rw /usr 

2. unset4 /usr/bin/uucp /usr/lib/uucp/* 

To determine if a process has a 4-Mbyte limit, issue the /usr/etc/check4 command. If it 
does not have a 4-Mbyte process limit, check4 displays the message process is not a 4MB 
process. If the process is a 4-Mbyte process, then check4 merely redisplays the prompt. 

Reference: On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — check4(8), set4(8), unset4(8) 
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5.1 Restricted Networks 

A Sun386i system, when connected to a network to which it is not yet known, can probe for its 
IP address using DRARP. The response that servers on the network make to such a request can 
be controlled by restricting the network. When a network is restricted, Sun386i systems will not 
be able to automatically install themselves. 

For more information on how this works, see Chapter 9. 

Customer sites can restrict the network so that new Sun386i systems will not automatically join a 
YP domain via Automatic System Installation. On a network running YP: 

1. Log onto the YP master server of the domain and become root. 

2. Edit the /etc/policies file. Setting pnp to restricted (this restricts the network, so 
that new Sun386i systems cannot use ASI to join the YP domain). If the YP master is a non- 
Sun386i system, see Chapter 7 for information about adding the policies map. 

3. Enter cd /var/yp? make 

Automatic System Installation and multiple domains —Special rules apply when 
using ASI on networks with multiple domains. The ip_address_allocation policy 
should be set to drarp_only on only one domain on a network. See “Setting Up Addi¬ 
tional Sun386i YP Domains” in Chapter 8 for details. 

Automatic System Installation enabled by default — Automatic System Installa¬ 
tion is enabl^ in the policies map on Sun386i systems set up as YP master servers; 
therefore Sun386i networks are unrestricted by default. 

What Users See on a Restricted Network 

On a restricteid network, if a user attempts to add a system by plugging in and powering up a 
new system, he or she will see the following message: 

This Network is Restricted 

The user is also directed to contact the network administrator, with the Ethernet® address of 
the workstation, to have the proper files set up (either using SNAP or manual procedures). 

SNAP mns on both restricted and unrestricted networks. If you add systenois manually instead 
of using SNAP, use care to ensure that all the files are updated properly if you subsequently 
want to administer those systems with SNAP. This is because SNAP cannot always deal with in¬ 
consistencies in these files. 

Reference: Chapter 9 of this manual (“Booting a Network Client” and other related sections) 
Sun386i SNAP Administration (June 1989 edition. Chapter 8) 


A 
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5.2 Sun386i Probing 

Sun386i systems can probe the network every time they boot to obtain information about the 
environment. The various types of probing (in the order they are performed), are: 

♦ Network probing 

♦ IP address probing 

♦ Configuration probing 

Reference: Chapter 7 of this manual (“Adding New Sun386i YP Files and Maps” section) 
Chapter 8 of this manual (“About Configuration Probing in Multiple Domains” 
section) 

Chapter 9 of this manual (“Booting a Network aient” section) 

Chapter 10 of this manual (net. conf and policies descriptions) 

Sun386i Advanced Administration (Febraary 1989 edition, Chapters 1,2) 
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Network Probing 

To determine if the network is connected, a Version 2 Ethernet packet is sent to the Loopback 
Assistant, using a multicast address. The system determines that the network is connected if 
there are no transmission errors. No response to this packet by another system is required (if 
another system responds, the response will be ignored). 

Network probing is used to initially determine if the system should be set up as a standalone 
system. On subsequent boots it detects changes in network role (from standalone to net¬ 
worked) or reports errors when a networked system is no longer connected to the Ethernet. 

All Sun386i systems perform network probing the first time they boot (when the system is new 
or after unconf igure(8) has been mn). 

On subsequent boots, Sun386i diskless systems always perform network probing, while all oth¬ 
er Sun386i systems only probe the network if PNP=yes in the /etc/net. conf file. 

^ Ethernet packet function code — The function code of the Ethernet packet sent in 

network probing is a zero (0), which can cause error replies from a Loopback Assistant. 

IP Address Probing 

To determine the proper IP address to use for a given machine’s Ethernet address, a Sun386i 
can broadcast a DRARP request for its IP address (all other Sun systems use the RARP proto¬ 
col, DRARP is an extension of RARP). The IP address is returned by a YP server running 
rarpd (8). The server returns information which is found either in the ARP cache on the serv¬ 
er system, or the ethers and hosts maps. In the event that the IP address information is not 
found, a new IP address can be allocated automatically and returned. 

A Sun386i diskless system broadcasts a request for its IP address every time it boots. A Sun386i 
diskless chent initially uses RARP to resolve its IP address. If it receives no response to the 
RARP request, the Sun386i diskless system alternates DRARP and RARP requests until a server 
replies with the IP address. 

All other Sun386i systems use IP address probing the first time they boot (when the system is 
new or after unconf igure(8) has been run). On subsequent boots, Sun386i YP servers and 
standalone systems never use IP address probing, while all other clients only probe for their IP 
address if PNP=yes in the /etc/net. conf file. 

A DRARP packets between networks — During IP address probing, a Sun386i system 
broadcasts DRARP packets to the network. On large networks connected by Ethernet 
bridges, these Ethernet broadcast packets are sent to the entire network. This can result 
in a Sun386i conversing with a distant Sun386i and joining a YP domain which is physi¬ 
cally very far removed from the client. The machines appear to have conspired on the 
network. 

If the bridges can be configured so as to filter out DRARP packets (opcode 0x8035), this 
should be done. Typically, the “conspiring” of Sun386i systems does not occur when 
routers are used to connect network segments since routers do not forward Ethernet 
broadcast packets. 

Configuration Probing 

To detect network reconfiguration (such as changes in host or domain names), Sun386i client 
systems can broadcast an RPC request to obtain the following information from a server on 
the network each time they boot: 

♦ Domain name 

♦ Host name 

♦ Network role 

♦ Time zone 

♦ Time 
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A Sun386i YP server (which runs the pnp daemon, rpc. pnpd(8)) answers the configuration 
request The server returns information found in the hosts, ethers, and systems YP maps. 

Sun386i YP servers and standalone systems never perform configuration probing. Sun386i YP 
clients and diskless systems installed with the Sun386i diskless server kit do not perform config¬ 
uration probing the first time they boot Also by default, PNP=no in the /etc/net. conf file 
on those clients and therefore configuration probing is not done on subsequent boots. Con¬ 
versely, Sun386i network clients and diskless systems installed with ASI or SNAP do perform 
configuration probing the first time they boot Also by default, PNP=yes in the 
/etc/net. conf file on those clients and therefore configuration probing is done on subse¬ 
quent boots. 

Booting — A system with configuration probing enabled will not continue to boot, even 
to single-user mode, untO it receives the configuration information. 

Multiple domains — If a network has multiple domains that know about the Sun386i cli¬ 
ent in their YP maps and have Sun386i YP servers in different domains, you must take ad¬ 
ditional steps to control which domain the Sun386i joins when booting; see Chapter 8 
for details. 

^ net. conf (5) setting — If configuration probing is not enabled, the VERBOSE setting 
in /etc/net. conf is used instead of the NVRAM to enable boot messages from the 
rc . * scripts. 


Disabling Configuration Probing 

To disable configuration probing on a boot client so that a system gets its configuration infor¬ 
mation locally, perform the following steps: 

1. Log in to the system as root. 

2. Create an /etc/hosts file containing the name of the local system, 
ypinatch hostname hosts > /etc/hosts 

If single-user mode is often used, also add the addresses of any hosts typically accessed to 
the /etc/hosts file. 

3. Copy /usr/etc/if conf ig into /sbin to configure the network when booting. 

4. Edit /etc/net. conf, changing PNP=yes to PNP=no. 

5. Reboot tltiis system; it will boot without perfomiing configuration probing. 

Because this procedure sets the system up to use if conf ig (rather than netconf ig), it dis¬ 
ables network probing (except for diskless clients), the DRARP portion of IP address alloca¬ 
tion (again, except for diskless clients), and configuration probing. 

Re-enabling Configuration Probing 

To re-enable configuration probing on a network, diskless, or diskful client, perform the fol¬ 
lowing steps: 

1. Check that the system’s Ethernet address is in the YP ethers map (on the YP master) by 
entering: 

ypcat “k ethers | grep hostname 

Do not enable configuration probing unless this entry exists. 

2. Make sure that there is an available Sun386i boot server in the same domain by entering 
the command: 

/usr/etc/rpcinfo -b ypserv 2 

and checking for names of Sun386i systems. Do not enable configuration probing unless a 
Sun386i YP master or slave server exists. 
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3. Become root on the system. 

4. Edit /etc/net. conf , changing PNP=no to PNP=yes. 

5. Make sure /sbin/netconf ig exists, and then delete /sbin/if conf ig. 

6. Delete /etc/hosts. 

Disabling probing — If you disable configuration probing, the system reconfiguration 
procedures discussed in Sun386i SNAP Administration will not work. 

^ net. conf (5) — There is no on-line or hard-copy man page describing the 

/etc/net. conf file. (NOSDR) 

Single-User Mode and Configuration Probing 

If Sun386i boot servers aren’t running or the network is down, you can still work locally by do¬ 
ing the following steps: 

1. Press Ll-a to get to the PROM monitor prompt (>). 

2. Boot the system in single-user mode by typing b -bs 

3. Repair any possible file system inconsistencies by entering /sbin/f sck 

4. Remount the root file system for root access by entering mount -o remount, rw / 

5. Clear the mount table by entering > /etc/mtab 

6. Mounttherootand/usr file systems by typing mount -f /; mount /usr 

7. Reset the terminal characteristics by typing stty dec 

8. Mount all file systems on the disk by entering mount -at 4.2 

9. Mount all loopback-mounted file systems by entering mount -at lo 

5.3 checkconfig Program 

The checkconfig program is similar in concept to f sck(8). checkconfig verifies that the 
configuration of a Sun386i system is correct in the YP maps and requests corrections in the YP 
databases on the YP master, if necessary. 

Each time a Sun386i system boots, it automatically mns the checkconfig program from the 
/etc/rc script, checkconfig checks to see if the system is a YP server, checks if this system 
has a valid entry in the systems map, and checks if this system has a valid entry in the 
bootservers map if this system is a YP server. 

# Sun386i SunOS 4.0.2 — If the YP master for the system mnning checkconfig is not 

a Sun386i running SunOS 4.0.2, checkconfig fails when trying to update the systems 
and bootservers YP maps. This is because only Sun386i SunOS 4.0.2 has the soft¬ 
ware necessary to perform the update. If the system displays verbose messages, the 
error: 

yp updated failed, returned YPerr code 6 
will be displayed when rebooting. 

no man page — checkconfig does not have a man page on-line or in the SunOS 
Reference Manual. 

YP Server Check 

If checkconfig determines that the system is a YP server and it does not have a local copy of 
the YP maps, it copies the maps from the YP master (using ypsync(8)) and reboots the sys¬ 
tem. If checkconfig determines that the system is not a YP server but it does have a local 
copy of the YP maps, it deletes the maps from /var/yp/domain_name and reboots the 
system. 
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systems Map Check 

If checkconf ig does not find an entry for this system in the YP systems map, 
checkconf ig contacts the ypupdated daemon on the YP master, wlpch makes an entry for 
this system. If the systems map contains an entry for this system but the information is incor¬ 
rect, checkconf ig contacts ypupdated on the YP master, which corrects the entry. 

bootservers Map Check 

If this system is a YP server but lacks an entry in the YP bootservers map, checkconf ig 
contacts the ypupdated daemon on the YP master, which makes an entry for this system. If 
an entry for this system exists in the bootservers map but the information is incorrect, 
checkconf ig contacts ypupdated on the YP master, which corrects the entry. 


5.4 IP Addresses 

The IP (network) address on any Sun system consists of four fields separated by periods, with 
each field containing a number from 0 through 255. These four fields are grouped into two 
parts: 

♦ The network number, which is the same for all systems on the network 

♦ The system number, which is unique to this system within the network; the range of available 
system numbers for a network is determined by the network number 

The class of network determines which fields of the IP address form the network number and 
which fields form the system number. 

♦ Class A networks — The network number is the first field of the address, and the last three 
fields form the system number. The first bit of a class A address is zero, for example, 
127.9.200.1. 

♦ Class B networks — The first two fields of the address form the network number, and the sec¬ 
ond two fields form the system number. A first bit of one and a second bit of zero denotes a 
class B address, for example, 128.9.200.1. 

♦ Class C networks — The first three fields of the address form the network number, and the 
fourth field is the system number. Many Sun systems are on class C networks. Class C ad¬ 
dresses have a first and second bit of one, for example, 192.9.200.1. 

Class A IP Address Class C IP Address 

127 . 9 . 200.1 192 . 9 . 200.1 

/ ' — ' \ 

Network Number System Number Network Number System Number 

In addition, some sites split large networks into subnetworks by using part of the system num¬ 
ber to designate a subnet number. System & Network Administration describes how to estab¬ 
lish subnetworks. 

You assign IP addresses to Sun-3, Sun-4, and SPARCstation systems during the 
suninstall process. Sun386i systems can assign default IP addresses automatically during 
Automatic System Installation (ASI) or via SNAP. However, you should assign a nondefault 
number if you might later connect this network to another. Contact the Network Information 
Center (NIC) at 1-800-235-3155 to obtain a unique network number for your site if you do not 
already have one and plan to join the Internet. (Some sites may already have a range of net¬ 
work numbers from NIC; contact the head of network services at your site to check if this is the 
case.) 
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IP address assignment — You can control the assignment of BP addresses for each 
system allocated by SNAP or Automatic System Installation by creating the 
/etc/ipalloc. netrange file on the master server (see the ipalloc. netrange(5) 
man page). Whenever SNAP or Automatic System Installation (ASI) must assign an ad¬ 
dress, it chooses an address from the pool specified in this file, if it exists. 


^ Range maximum — If you specify more than 40 ranges, the ipallocd(8C) daemon 

ignores additional ranges supplied, without printing a warning. 

Reusing a system number — If a system is removed within one hour after being add¬ 
ed with SNAP, you cannot reuse its IP address, and therefore its system number, until 
the one-hour period has expired. If you use SNAP to add a system and try to reuse the 
system number within that hour, SNAP responds that the system number is already in 
use. 


Reference: Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

Sun386i Advanced Administration (Febraary 1989 edition. Chapter 2) 

System & Network Administration (Chapter 12) 

Changing the BP Address on Sun386i Systems 

The steps to change an IP address are similar for all Sun systems, and depend on the circum¬ 
stances necessitating the change. The table in this section provides steps to: 

♦ Change an address of an individual Sun386i system, when moving it to a different network or 
to another location on the same network 

♦ Change the address of all Sun386i systems (when subnetting or merging two networks, for ex¬ 
ample) 

For information on changing YP domains, see Chapter 8. 

The following table is arranged sequentially by network role. If you are moving an individual 
system, perform only the steps associated with that system, as shown in the left column. Simi¬ 
larly, if you are changing all addresses but the network does not include systems of a particular 
network role, then skip the steps associated with those systems. For instance, if the network 
does not have any slave servers, skip steps 4-6. 
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If Changing EP Address 
of This Sun386i System 


All Clients 


All Systems 


Slave Servers 


All Systems 


Master Server 
Slave Servers 
Diskless Clients 


AD aients 


Do These Steps 


1. As superuser on each client, change the client’s address 
and address of the client’s boot server in /etc/hosts 
(clients with configuration probing enabled won’t have this 
fde). 

2. Shut down each client by entering /etc/halt 

3. Remove the ARP cache entry for the old IP address by per¬ 
forming one of the following three steps: 

♦ Leave any system getting a new IP address off for one hour. 

♦ As supemser, enter the foUowing on aD systems on the net- 
woric for each client whose address is changing: 

arp -d hostname 

♦ Reboot aD systems on the network. 

4. As supemser on each slave server, replace the old address 
with fte new one in the /etc/hosts file. 

5. Delete the /var/yp/domain_name directory from each 
slave server. 

6. Shut down each slave server by entering /etc/halt 
and powering down. 

7. As supemser on the master server, change addresses for each 
system in /etc/hosts and /etc/networks. Also update 
/etc/netmasks if the new IP addresses are in a different 
subnet. 

8. Remake YP maps on the master server (cd /var/yp; make). 

9. As supemser, reboot the master server (/etc/reboot). 

10. Turn on all slave servers. 

11. Copy the new version of /etc/hosts from the master 
server by entering the following on each boot server: 
rep master_name: /etc/hosts /etc 

12. Get the hexadecimal equivalents for the new network 
addresses for each server’s diskless clients by entering: 
/Usr/etc/iiistal3/script/oon[vert_to_hex lP_addiess 

13. On each cDent’s boot server, log in and as supemser update 
the symbolic links for each diskless cUent’s boot file to reflect 
the new IP address. In the /tf tpboot directory, enter 

•nv-(Wjipjiddtess.<3386,sun3,sun^ newjp_acldiess.<s^siii3,suo4> 

14. On any NFS server of clients with new IP addresses, re-export 
the file systems to get the new host information by entering: 
erport-fs -a 

15. Turn on. 
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5.5 Upgrading a Standalone System to the Master 
Server 



How you upgrade a system that’s been set up as a standalone (not connected to a network) to a 
YP master depends on whether you: 

♦ Can use the default IP address (192.9.200. l) and YP domain name (yp. noname); use 
the default IP address only if this network will not be connected to another one. 

♦ Want to unconfigure the system; Chapter 2 of Sun386i SNAP Administration (June 1989 edi¬ 
tion) gives instructions on how to do this. 

D YP masters — Sun386i standalone systems are YP masters of a network of one system. 

^ unconfigure — The Sun386i unconf igure(8) command had a bug in Sun386i 
SunOS 4.0.1 whereby the command deleted all software in /f iles/vol. This is fixed 
in Sun386i SunOS 4.0.2. 

Using Default IP Address and YP Domain Name 

1. Plug in the Ethernet transceiver cable. 

2. Log in to the workstation as root 

3. Reboot the system. 

4. Follow the directions that will appear on the screen. 

Using Nondefiuilt IP Address and YP Domain Name 

1. Plug in the Ethernet transceiver cable. 

2. Log in to the workstation as root 

3. Edit the /etc/net. conf file by: 

a. Changing the NETWORKED=no line to networked=yes 

b. Changing the domain name value — DOMAlNNAME=new_domain_name 

(YP . domain_name is a SunOS 4.0 convention, and is recommended for 
Sun386i systems) 

c. Setting the PNP value to pnp^YES, if it is currently set to NO 

4. Edit the local /etc/hosts file on this system. The /etc/hosts file will contain one 
entry: 

127.0.0.1 hostname localhost loghost mailhost timehost # Desktop 

a. Replace the IP address (127.0.0.1) with the IP address for this system. 

b. Delete the word localhost from the line. 
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c. Add the following line: 

127.0.0.1 localhost 

For example, if the new IP address is 192.9.200.1 and the host name is spam, then the 
lines in /etc/hosts would be: 

192.9.200.1 spam loghost mailhost timehost # Desktop 
127.0.0.1 localhost 

Pay attention to the guidelines in the procedure for “General Steps: Setting Up Multiple 
Domains” in Chapter 8 because you may need to set some domain policies if this is not 
the only YP domain on this network. You might also have to change the domain name; 
see Sun386i Advanced Administration for details. 

5. For SNAP to recognize this system as a YP master, add an entry for this network to the local 
/etc/networks file, using the syntax: 

network_name network_number aliases 

For example: 

the_network 192.9.200 localnet 

6. Display the contents of the /etc/publickey file. If it contains the old domain name 
(YP. noname), replace the old name with the new domain name (for example, 

YP. new_domainname). 

7. Similarly, edit the /etc/netgroup file, replacing all occurrences of the old domain 
name with the new one. 

8. Force the rebuilding of the net id YP map, so that services using Secure RPCs can validate 
superuser on this system: 

cd /var/yp 
rm netid.time 

9. Remake the YP maps by entering cd /var/yp; make 

10. Rename the default domain name directory with the new domain name: 
cd /var/yp 

mv YP. noname new_domainname 

11. Reboot the system. It will come up as a YP master, using the address you gave it in step 4. 

|||i YP master recognition — For SNAP to recognize this system as a YP master, and to be 
able to add other systems to the network with SNAP, the /etc/networks file on this 
system must contain an entry for this network. See the networks(5) man page for file 
format details. 

Reference: Chapter 8 of this manual (“General Steps: Setting Up Multiple Domains”) 

Sun386i Advanced Administration (February 1989 edition. Chapter 2) 

Sun386i SNAP Administration (June 1989 edition. Chapters 2,7,8) 

On-line Sun386i SunOS 4.0.2 man pages (man pages optional cluster must be 
loaded) - networks (5) 
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5.6 Adding Non-Sun386i Clients to Sun386i 
Networks 



Sun-3/4 
with disk 


□ 

J. 



YP Running 



YP master 


You can use SNAP to add a Sun-3, Sun-4, or SPARCstation system to a Sun386i YP network (a 
YP network with a Sun386i master server^ SNAP automatically adds entries to the same YP 
maps that it does when you add a Sun386i system with SNAP. You can also add a Sun-3/4 or 
SPARCstation client to a Sun386i YP domain without using SNAP. Both methods follow. 

^ Diskless non-Sun386i systems — Because Sun386i systems do not support 

suninstall(8), diskless Sun-3, Sun-4, or SPARCstation systems cannot be served by 
Sun386i systems. 


Adding a Non-Sun386i Client Using SNAP 

Sun386i SNAP Administration explains how to use SNAP to add a Sun-3/4 or SPARCstation 
client with a disk. After adding the client to network files, you must mn suninstall on the 
Sun-3/4 or SPARCstation system before it will boot, suninstall loads software onto non- 
Sun386i systems and prompts for configuration information for that system. Regardless of 
whether or not you use SNAP to add a non-Sun386i client, you must run suninstall on the 
client 

When mnning suninstall, be sure to follow the disk partitioning guidelines in Sun386i 
SNAP Administration (June 1989 edition. Chapter 8). Also, when prompted for a domain 
name, specify the Sun386i YP domain name (which, by convention, starts with YP). 

When suninstall finishes, you then must manually set up printers (see Chapter 1), user ac¬ 
counts (see Chapter 3), and mail delivery (detailed later in this ch^ter). Also, if you want to 
run the automounter on this system, you must start it (see Chapter 9). 

Reference: Chapter 1 of this manual (“Installing Printers” section) 

Chapter 3 of this manual (“Creating and Maintaining User and Group Accounts” 
section) 

Chapter 9 of this manual (“Inside the Automounter,” “Adding a Network Client 
Through SNAP” sections) 

Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 1) 

Installing the SunOS (Chapters 3, 8) 

Sun Software Technical Bulletin (December 1989) 

Adding a Non-Sun386i Client without Using SNAP 

If you don’t want to use SNAP to add a Sun-3/4 or SPARCstation client with a disk, you must: 

1. Manually add client information to the /etc/hosts file (also to /etc/systems and 
/etc/ethers files, if you want to use SNAP to display fliis system’s information) on the 
YP master. 
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2. Propagate changes to the YP maps (cd/var/yp; make). 

3. Run suninstall on the client. See the instructions in Installing the SunOS for details. 

Reference: Chapter 10 of this manual (ethers, hosts, and systems descriptions) 

Installing the SunOS (Chapters 3,8) 

Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

5.7 Upgrading a Client to a Slave Server on a 
Sun386i Network 

How you upgrade a client to a slave server on a Sun386i network depends on whether or not you 
have a user in the networks group. 

No User in networks Group 

1. Log in to the master YP server as root. 

2. Add the client that you’re upgrading to a slave server to the /etc/ypservers file. 

3. (Optional) If you want SNAP to display a system as a slave server, edit the entry for the sys¬ 
tem in /etc/systems, changing its network role to slave_bootserver. 

4. Remake the YP maps by entering cd /var/yp; make 

5. Log out on the master YP server. 

6. On the system that you are upgrading to a YP slave server, log in as root. 

7. Get a local copy of the YP maps by entering: 

/usr/etc/yp/ypinit -s master_server_name 

8. Reboot the system. This starts ypserv and on Sun386i systems runs checkconf ig, which 
adds this system to the systems and bootservers YP maps. 

^ Sun386i Advanced Administration — Both commands in step 4 on page 24 are 
missing a required master_server_name argument The commands should be: 

/usr/etc/yp/ypinit -s master_server_name (for SunOS 4.0) 

/etc/yp/ypinit -s master_server_name (for SunOS 3.x) 

User in networks Group 

1. On the system you are upgrading to a YP slave server, log in as a user in the networks 
group. 

2. Add this system to the ypservers YP maps and get a local copy of the YP maps by 
entaing: 

/usr/etc/yp/ypinit -s 

3. Reboot the system. This starts ypserv and rans checkconf ig, which adds this system to 
the systems and bootservers YPmaps. 

Reference: Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 2) 
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5.8 Installing Sun386i Clients on a Network with a 
Non-Sun386i Master 
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This section describes adding a Sun386i client, with or without a disk, to a Sun-3/4 or 
SPARCstation YP network (one that doesn’t have a Sun386i master). The following informa¬ 
tion pertains to all Sun386i clients being added to a non-Sun386i network. 

y Configuration probing disabled — Configuration probing is automatically disabled 
when you add a Sun386i system to a Sun-3/4 network through ASI (using option 3, to 
join as a YP client). Sun386i systems with configuration probing turned off use the 
/etc/net. conf file for some information that is set in the rc . * files for other Sun sys¬ 
tems. See Chapter 10 for more information on net. conf. 

ijk Automounter and ypprintcap — You must perform additional steps if you want to 
use the following features, both of which are described in Chapter 7: 

♦ Automatic mounting of NFS directories via the automounter 

♦ Use of ypprintcap features on Sun386i systems 

Missing features — If you add a Sun386i YP client to a YP domain that has a 
non-Sun386i system as the YP master, the Sun386i system lacks the following services: 

♦ All SNAP services except backup and restore 

♦ The ability to add new users via New User Accounts (logintool works, though) 

♦ Uniformly accessed applications and home directories through /vol and /home, 
respectively 

♦ Automatic access to newly added printers from Sun386i systems 

♦ Configuration probing 

♦ Mail delivery to home directories 

You can acquire the last four services above if you add Sun386i YP maps to the non- 
Sun386i YP master, as described in Chapter 7. 

^ SNAP help — When you press the Help key over a grayed-out SNAP category, the mes¬ 
sage that appears states that YP is not running. This is not necessarily the case. SNAP as¬ 
sumes that YP is not running if it cannot find all of the YP maps that it uses, some of 
which are specific to Sun386i systems. 

Reference: “Sun386i Probing” earlier in this chapter 
Chapter 7 of this manual 

Chapter 10 of this manual (net. conf description) 

Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapters 3, 4,9) 
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Installing a Sun386i Client with a Disk 

1. As root on the YP master, edit /etc/hosts by: 

a. Adding the IP address and system name. 

b. Adding t imehost to the list of aliases for a server that is typically available (such 
as the master YP server) so that when a Sun386i system boots and rans 
/etc/rc. local, it synchronizes its time with this time host. For example: 

192.9.200.1 master tlmehost 

2. Remake the YP database by entering cd /var/yp; make 

3. Attach the Sun386i system to the network and turn it on. 

4. From the menu that appears, choose: 

3. Join an Existing Yellow Pages Domain as a YP Client. 

5. Set up the time zone and network settings, as prompted. 

As with Sun-3/4 and SPARCstation systems, you must manually administer Sun386i systems be¬ 
cause SNAP is unavailable. Also, all Sun systems running SunOS 4.0 or later always set the sub¬ 
net mask through the YP netmasks map, if it exists and contains a mask for the network. (See 
Chapter 10 for more information about the netmasks map.) 

Installing a Sun386i Client without a Disk 

A Sun-3 or Sun-4 system can serve a diskless Sun386i system, provided that the server is ran- 
ning: 

♦ SunOS 4.0 or later 

♦ YP 

♦ The server kit for Sun386i diskless systems (provided with Sun386i SunOS 4.0.1, and with 
Sun386i SunOS 4.0.2 for new customers) 

|g| Server kit — You must install the Sun386i diskless server kit on the Sun-3/4 system. The 
release notes Installing Sun386i SunOS 4.0.2 provide instructions on diskless server kit 
installation and use. 

Reference: Sun386i Administrator’s & Developer’s Notes for SunOS 4.0.2 
Sun386i Administrator’s & Developer’s Notes for SunOS 4.0.1 
System & Network Administration (Chapter 14) 
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5.9 Upgrading a Sun386i YP Client to a Slave 
Server on a Non-Sun386i Network 



YP Running 


Sun386i systems can be slave servers on networks that do not have a Sun386i YP master server. 
In addition to offering the same features as any Sun slave server, Sun386i YP slave servers also 
can respond to configuration probing requests that Sun386i clients might send. If Sun386i cli¬ 
ents have configuration probing enabled, a Sun386i YP server is required to answer client re¬ 
quests for information such as host name and domain name. Configuration probing is 
disabled automatically on Sun386i clients added to networks with non-Sun386i YP masters via 
ASI. However, if a Sun386i slave server is on the network, you can re-enable configuration 
probing on these clients (“Configuration Probing” earher in this chapter provides details). 

A Sun386i YP server verifies its network role and starts all the relevant boot server daemons ev¬ 
ery time it boots. Every half hour the ypsync program (a Sun386i feature) on all Sun386i YP 
servers automatically verifies that the most up-to-date version of the YP maps is being used. 

A Restricted network required — When adding a Sun386i slave to a Sun-3/4 domain, 
be sure to make the network restricted by setting pnp to restricted in the file 
/etc/policies on the YP master. (You should also set the other policies values as 
shown: 

newlogin restricted 
ip_address_allocation none 
mail_delivery spool_area 

“Adding New Sun386i YP Files and Maps” in Chapter 7 provides details. 

If you don’t restrict the network, the Sun386i slave server can allocate network re¬ 
sources, such as IP addresses, without recording them in the master copy of the YP 
maps. 

These steps upgrade a Sun386i chent to a YP slave server. To add some of the Sun386i network 
administration features to a non-Sun386i network, see Chapter 7. 

1. Log in to the master YP server as root. 

2. Add the client that you’re upgrading to a slave server to the ypservers map on the YP 
master. To do this, issue the following commands: 

cd /var/yp/domainname 

/usr/etc/yp/makedbm -u ypservers > /tmp/ypservers 
echo Sun386i_hostname >> /tmp/ypservers 
/usr/etc/yp/makedbm /tmp/ypservers ypservers 
/usr/etc/yp/yppush ypservers 

Ignore the message YP server not registered at Sun386i_hostname. This indicates 
that the master was unable to push the YP maps to the slave server. The slave server will re¬ 
trieve a copy of the maps when you run ypinit (step 5 of this procedure). 
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3. Log out on the master YP server. 

4. Log in as root to the Sun386i chent that you are upgrading to a slave server. 

5. Get a local copy of the YP maps by entering /usr/etc/yp/ypinit - s 

If you see the error message ypsync: You do not have the 'networks' privilege, 
this indicates that you did not perform step 2 correctly. 

6. Reboot the system. 

Reference: Chapter 7 of this manual (“Adding New Sun386i YP Files and Maps”) 


5.10 Installing Sun386i Systems on Non-YP 
Networks 



You can add a Sun386i system with a disk to a network that is not running YP. However, be¬ 
cause the installation menus set up the Sun386i system with YP mnning, you must decide if you 
want to continue running YP on the Sun386i system, or if you should turn YP off. 


A 


Diskless Sun386i systems — Diskless Sun386i systems cannot be installed on a net¬ 
work that is not running YP. 


y YP use — Sun386i systems automatically enable YP when they boot. 


||^ SNAP requirements — SNAP will not run on Sun386i systems that are on non-YP net¬ 
works unless you configure a Sun386i system as the master YP server for all Sun386i sys¬ 
tems, which changes the network into a Sun386i network mnning YP. 


^ /bin/mail — For Sun386i SunOS 4.0.1, /bin/mail required YP to deliver mail. 
(You could still send mail and read it by NFS mounting /var/spool/mail from an¬ 
other system.) /bin/mail does not require YP in the Sun386i SunOS 4.0.2 release. 

Reference: Sun386i SNAP Administration (June 1989 edition. Chapter 8) 

Sun386i Advanced Administration (Febmary 1989 edition, Chapters 3,9) 

Installing a Sun386i System Not Running YP 

1. Do not plug the Sun386i system into the network. 

2. Set up tlie new Sun386i system by following the instmctions in the “Disabling YP” section 
of Chapter 6. 

3. Select an IP address for this system, and then make sure it is not already in use by checking 
the contents of /etc/hosts on another Sun system that is part of the network that this 
Sun386i system will join. The network number will be the same as the other systems, but 
the system number must be different. (See “IP Addresses” earlier in this chapter for an ex¬ 
planation of address components.) 


Chapter 5 - Establishing and Maintaining a Network 


59 


Sun386i Administration Cookbook 


4. As root, edit the local /etc/hosts file on this system. The /etc/hosts file will contain 
one entry: 

127.0.0.1 hostname localhost loghost mailhost timehost # Desktop 

a. Replace the IP address (127.0.0.1) with the IP address for this system. 

b. Delete the word localhost from the line. 

c. Add the following line: 

127.0.0.1 localhost 

For example, if the new IP address is 192.9.200.57, then the lines in /etc/hosts 
would be: 

192.9.200.57 hostname loghost mailhost timehost # Desktop 
127.0.0.1 localhost 

5. Connect the Sun386i system to the network and reboot the system. 

6. Log into the Sun386i system as root. 

7. Add any other systems already on the network to the /etc/hosts file on the Sun386i sys¬ 
tem. You can get the required information from /etc/hosts on another Sun system on 
the network. 

8. Add any network user accounts to the local /etc/passwd and /etc/group files on the 
Sun386i system. You can get this information from the /etc/passwd and /etc/group 
files on another Sun system on the network. 

9. Check the time and date and reset them if they are incorrect, using the date(l) com¬ 
mand. You might want to add cron jobs to synchronize the time automatically at a given 
interval (for instance, once a day). 

Converting a Non-YP Network into a Sun386i YP Network 

If the Sun386i system is to run YP in a network that was not previously mnning YP, you can set 
up the Sun386i system as the master YP server. Sun386i SNAP Administration and the 
“Upgrading a Standalone System to the Master Server” section earlier in this chapter describe 
two procedures for doing this. 


5.11 Setting Up and Administering Mail 



Home directory delivay — On Sun386i systems in a YP domain that has a 
policies map with niail_delivery set to home_directory (the default), mail is 
delivered to the user’s home directory, ensuring that users can read mail from any 
Sun386i Systran with the home directory mounted. 


Aliases — On Sun386i systems, an alias is automatically set to a user’s home directory 
server for each user when you use SNAP or New User Accounts to create an account. 
(On non-Sun386i systems, administrators must add an entry to /etc/aliases on the 
YP master and then remake the YP maps.) 


As an alternative, you can have mail delivered to the spool directory on Sun386i systems, as 
on other Sun systems. Mail delivery on a Sun386i system works exactly as on other Sun systems 
if either 


♦ YP is not running on the Sun386i system, or 

♦ This system’s niail_delivery policy in the policies map on the YP master is not set or 
is set to spool_area 

Reference: Chapter 8 of this manual (for multiple domain issues regarding mail) 

Sun386i Advanced Administration (Febraary 1989 edition. Chapter 9) 
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Sending Mail 

Here’s what happens when a user delivers mail to another system: 

1. If the message is addressed to another system either exphcitly (usemame@system) or im¬ 
plicitly (username, where username is an alias for useraame(§system), the 
/bin/mail(l) program on the local system passes the message to the local sendniail(l) 
program. 

If the message is addressed to someone on the local system (the sender’s system is also the 
addressee’s system), then /bin/mail delivers the message; sendmail is not involved. 

If the message is addressed to a user who is not known by the sending system (the user has 
neither a login ID nor an alias entry), and no other system is specified, then /bin/mail 
returns the mail to the sender with an error message. 

2. The local sendmail program routes the message to remote sendmail programs until 
each addressee’s system is reached. 

3. sendmail(l) on each addressee’s system passes the mail to /bin/mail. 

4. On Sun386i systems only, /bin/mail checks to see if YP is running. 

If YP is not mnning, /bin/mail automatically delivers the mail to 
/var/spool/mail/usemame. 

If YP is running, /bin/mail checks the mail_deliverY policy in the YP policies 
map. If the policy is set to home_directory, then /bin/mail checks the auto. home 
map to see if the receiving system is the home directory server. If it is, /bin/mail deliv¬ 
ers the message to /home/usemame/mail/inbox. If this machine is not the addressee’s 
home directory server, /bin/mail returns the mail to the sender’s system with an error. 

If themail_deliverY policy is set to spool_area, /bin/mail delivers the message to 
/var/spool/mail/usemame on the mail server (the same location as for Sun-3, Sun-4, 
or SPARCstation mail delivery). 

Hie diagrams on the next page show how mail delivery works on Sun386i and on Sun-3, Sun-4, 
and SPARCstation systems. 


Chapter 5—Establishing and Maintaining a Network 


61 


Sun386i Administration Cookbook 


Mail Dclixcry Between Sun386i Systems 



Sender^s system Receiving system Master server 


/bin/mail —[^3^ sendmail ' » sendmail —/bin/mail 

Is YP running? ■■■ —— yes —— » If mail.delivery policy - spooLarea 



Mail DclivcQ Between Sun-3, Siin-4, or SPARCslation Systems 



Sender’s system 
/bin/mail — lN/| i»> sendmail 



Receiving system 
sendmail — IN/I ^ /bin/mail 


13 

\ 

/var/spool/mail/<user> 
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Reading Mail 

When a user reads mail on Sun386i systems using mailtool(l), /usr/ucb/Mail deteimines 
the location of a user’s mailbox by checking the mail environment variable. This variable is 
set to -/mail/inbox in the default Sun386i . login file. 

When a user reads mail on a Sun-3, Sun-4, or SPARCstation system, /usr/ucb/Mail dis¬ 
plays the contents of /var/spool/mail/usemame. 

Mail Delivery to a Spool Area 

To have mail for all users in a YP domain delivered to a spool area rather than to home direc¬ 
tories, or to enable users with accounts created on Sun386i systems to have their mail deliv¬ 
ered to a non-Sun386i system instead of to a Sun386i system, perform the following steps: 

1. Become superuser on the YP master server and edit the /etc/policies file if it exists. 
Change the line: 

niail_delivery home_directory 

to: 

mail_delivery spool_area 

2. Still as superuser on the YP master, include an alias for each Sun386i user in 
/etc/ypaliases if the master is a Sun386i system, or in /etc/aliases if the YP mas¬ 
ter is a Sun-3/4 system. Use the format: 

user:user@mail_SCTver 

where mail_server is the name of the non-Sun386i system that is to receive the mail. 

3. Remake the YP policy map by entering the command: 
cd /var/ypf make 

4. Have each user comment out the following line, if it exists, in his or her . login file: 
fsetenv MAIL -/mail/inbox 

5. Tell users to log out and log back in again so that the . login file change takes effect 

6. For each group, edit /home/groupname/def aults/. login and comment out this 
same line. (This will ensure that new users added through SNAP or New User Accounts get a 
corrected . login file.) 

7. Now mail will be delivered to the spool area (/var/spool/mail) on the machine speci- 
fied for each user in the aliases map (as in usemame@system), as on Sun-3, Sun-4, and 
SPARCstation systems. A user can either: 

♦ Read mail on system 

♦ Use NFS to mount /var/spool/mail from system onto any system fi-om which the us¬ 
er wants to read mail 

For example, if the mail server is a Sun386i system, as supemser add the following line to 
/etc/exports on the mail server: 

/export/var/localhost/spool/mail 

Then, also as supemser, enter the following line into the /etc/f stab fOe on any system 
fi'om which users will read mail: 

mailboxj3erver:/e35)ort/varAocalhost/spc»lABil /var/spoo^/taail. nfs rw 0 0 

Be careful not to give root access to clients that mount the mail spool directory: with root 
access, it is easy for users (or programs such as unconfigure) to unwittingly remove or 
overwrite other users’ mailboxes that reside on the mailbox server. When exported as just 
shown, the default is no root access. 
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|N SNAP and New User Accounts — User accounts created by SNAP and New User Ac- 
^ counts (NUA) are set up so that users receive and read mail from tbeir respective home 
directories. (The mail_delivery policy on Sun386i domains is set to 
home_directory and the MAIL environment variable in each user’s default . login 
file is set to -/mail/inbox.) SNAP and New User Accounts also make entries in the YP 
aliases map, creating user@home_server aliases, where home_server is the name 
of the home directory server (where mail is automatically sent). 

non-Sun386i mail file locking — Users whose mail is delivered to their home direc¬ 
tories should read their mail only when logged in to a Sun386i system. This is because 
mail services on Sun-3, Sun-4, and SPARCstation systems only support mail file locking 
on spool directories. 

Delivery policy — SNAP assumes that the mail delivery policy is set to 
home_directory. Therefore, if the mail delivery policy is set to spool_area, after 
creating a user account using SNAP or New User Accounts you must edit 
/etc/ypaliases on the master server. Change useraame@home_server (the entry 
tha t SNAP added to the file when it created the user account) to 
useraame(3mail_server. 

y /bin/mail — For 4.0.1, /bin/mail required YP even when it was not delivering mail 
to h(Mne directories, /bin/mail does not require YP in the Sun386i SunOS 4.0.2 
release. 

5.12 Setting Up and Using UUCP 

The same UUCP (UNDC-to-UNIX Copy Program) functionality is available on Sun386i systems 
as on other Sun systems. 

UUCP Process Size Differences 

As with many other Sun386i utilities in /etc, /usr/etc, /usr/bin, and /usr/ucb, uucp 
is a 4-Mbyte process. (See page 41 for a description of 4-Mbyte processes.) 

If you run uucp in a sheU that has a stack limit of 4 Mbytes (or larger) you’ll see the message: 

crtO: mmap of Id.so failed 

To avoid this problem in a shell set to a stack size limit that is too large, use the unset4 
command to change uucp so that it is no longer a 4-Mbyte process. 

Become superuser and enter the following commands: 

1. mount -o remount,rw /usr 

2. unset4 /usr/bin/uucp /usr/lib/uucp/* 

To determine if a process has a 4-Mbyte limit, issue the /usr/etc/check4 command. If it is 
not a 4-Mbyte process, check4 displays the message process is not a 4MB process. If the 
process is a 4-Mbyte process, then check4 merely redisplays the prompt 

[pg] comm cluster — The comm cluster, included with Sun386i Application SunOS software, 
must be loaded to use uucp. 
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% UUCP man page — The uucp(lC) man page refers to Installing the SunOS for informa¬ 
tion on installing optional software. That manual is pertinent only for installing soft¬ 
ware on Sun-3, Sun-4, or SPARCstation systems. 

Reference: System & Network Administration (Chapters 15,21) 

Sun386i Advanced Administration February 1989 edition. Chapters 4,9) 

On-line Sun386i SunOS 4.0.2 man pages (man_pages optional cluster must be 
loaded) — uucp(lC), check4(8), set4(8), unset4(8) 


5.13 Installing Third-Party Software 

Third-party software installation on Sun386i systems is basically the same as on other Sun work¬ 
stations, except as noted below. 

^ /usr — The /usr directory (except for /usr/local) is reserved for files that are 
bundled with SunOS. This can be a problem when third-party installation scripts load 
software into /usr, and do not permit customers to override this default location. Be¬ 
cause /usr is read-only and very full, you cannot store additional software in /usr 
unless you repartition the disk. 

Sun-3, Sun-4, and SPARCstation systems have an installation option whereby you can 
make /usr as large as you like. On Sun386i systems, you can remount /usr for write 
access and create a directory for loopback mounting or create a symbolic link from 
/usr to a partition such as /files, which has space available for adding software. 

/usr/local — /usr/local is usually private to a workstation, though it is shared be¬ 
tween a boot server and its diskless or diskful clients. This area is used only by a 
single architecture and is loopback mounted, typically to /f iles/local/sun386, 
so that it has as much space as is available on the local system. 

Third-party software — By Sun386i convention, /usr/local/application is where 
you should install third-party software if it’s going to be local to the workstation (but 
shared with diskless and diskful clients). You should install third-party software for net¬ 
work-wide use in /f iles/vol/application, and then make it available through the 
automounter. 

Shell scripts, binaries — On a Sun386i network, directories under /vol/local are 
the standard location to store shell scripts and binaries for all architectures. 

/vol/local is an automount point. Typically /f iles/vol/local on the master 
server is automounted on /vol/local. 

/vol — /vol is an automounted directory. To add new automount points by hand, edit 
/etc/auto. vol on the YP master and remake the auto. vol YP map. 

Search path — The default search path defined in the . cshrc file assumes a heteroge¬ 
neous site (/vol/local/bin. architecture, /vol/local, and /usr/local, are 
included in the default . cshrc file). 
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Where You Should Install Software 

The diagram below shows the default user search path on a Sun386i network. Where possible, 
try to install appUcations in one of these directories. 



I 

if not there, then search 

4 



if not there, then search 

4 



■ 

if not there, then search 

4 



if not there, then search 

4 



for architecture-specific 
personal binaries 


for personal shell scripts 


for architecture-specific binaries 
available network wide 


for shell scripts available 
network wide 


for architecture-specific binaries 
available only to the local system 


This search path allows individual users to have their own programs, allows site-wide installa¬ 
tions across the network, supports multiple processor architectures, and permits software in¬ 
stallation on individual workstations. Users don’t have to modify their environment to take 
advantage of software that’s been installed. 

^ unconfigure — In Sun386i SunOS 4.0 and 4.0.1, running the unconf igure(8) com¬ 
mand removed software from /f iles/vol. This is fixed in Sun386i release 4.0.2. 

Reference: Chapter 9 of this manual (“Inside the Sun386i File System” section) 

Sun386i Advanced Administration (Febmary 1989 edition. Chapter 6) 

Sun386i Developer’s Guide (Chapters 6,9) 
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HINTS AND TIPS 


Siin386/ YP Master Hints 



Siin386/ YP Master Hints and This month’s Hints and Tips include suggestions on how to solve ypserver 

Tips not responding and fsck inconsistency problems when rebooting 

Sun386/ machines. This rebooting was originally done by a customer trying to 
kill some logins.^ 

Use these hints when booting single user, using ypinit -m, and remaking YP 
does not allow proper booting. 

Multiple Problems and You can suspect that the original problem killing some logins, fsck 

Symptoms inconsistencies, and ypserver not responding are three symptoms of 

the same problem. 

This problem may have caused something on the disk to be lost, allowing the YP 
master to become confused and look for a ‘master’ when it is is master. 


The Procedure Use the below procedure to help overcome the ypserver not 

responding error message. 

1. Boot single user. 

2. Use the hostmme(l) command to set the hostname exactly as it is 
specified in the /etc/net. conf file. 

3. Use the domainname(l) command to set the domainname exactly as it is 
specified in the /etc/net. conf file, including the ‘ YP . ’ on the 
front 


^ This month’s hints ate submitted by Chuck Kollars, Sun ECD Marketing Support, Boston Development 
Center. 
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4. Edit the /etc/net. conf file. Ensure than PNP=no . Note that 
PNP=yes means to probe the network for configuration information, 
which a YP master or slave should not do. 

5. Edit the /etc/ypservers file. Ensure that the intended YP master 
system name is in this file. 

6. Edit the /etc/hosts file. Ensure that the three following conditions 
exist: 

First, ensure that there is an entry for this host. It should not include 
the loopback alias. 

Second, ensure that there are entries for loghost , timehost, 
and mailhost . Each may an alias on the entry for this host, or 
may point to some other host on the network. This depends on the 
network configuration and the customer’s wishes. 

Third, ensure that there is a separate entry for 127.0.0.1 
loopback. 

7. Edit the /etc/netgroup file. Ensure all domainnames are specified 
correctly, including ‘ YP. ’. 

8. Edit the /etc/publickey file. Remove all lines except the one for 
nobody. 

9. Remake the YP maps by using the commands shown below. 

# cd /var/yp 

# rm *.tlme 

# domalnname !* Check for correct output*! 

# hostname /* Check for correct output *1 

# make 


10. Remove stale secure RPC key information, as shown next 

# cd /etc 

# rm keystore 

# rm .rootkey 

11. Sync the disk and then reboot using the below commands. 

# sync 

# sync 

# reboot 
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The cleandisk Script 


This month’s Hackers’ Corner contains cleandisk, a short script that you 
can use routinely to clean up any extraneous or temporary files that might waste 
your disk space.^ 

cleandisk runs without intervention and displays in kBytes how much disk 
space is being freed for each file as it is being deleted. 

Why might you want cleandisk ? Occasionally, you will have a core dump 
file from a program that died or a typescript file that you forgot about from 
some script session you ran some time ago. Also, you may have opened a 
large file using textedit and created an equally large backup file that you no 
longer need. If you have such files taking up disk space, cleandisk may be 
for you. 

cleandisk checks your entire home file system. If you put it in your -/bin 
directory (or some other location contained in your $path variable), you could 
include it in your -/. logout file, or in your crontab file for regular 
cleanups. 

Please consult your local shell script or programming expert regarding any script 
or code problems. The example programs are not offered as a supported Sun 
product, but as items of interest to enthusiasts wanting to try out something for 
themselves. Note that Hackers’ Corner code may not work in all cases, and 
may not be compatible with future SunOS releases. 

Using the cleandisk Script Note that you may wish to edit the cleandisk script before running. In the 

original version, the files that are deleted may not match those you wish to 
delete. Each cryptic entry is commented for your convenience. 

^ This month's Hackers’ Comer is submitted by Bill Petro, GSG Marketing, Mountain View, California, 
USA. 
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Use the below procedure to run cleandisk . 

1. Save the script to a file named cleandisk . 

2. % chmod +x cleandisk 

3. % cleandisk 


The cleandisk Script 


The code for the cleandisk script appears below. 


For an online copy of the cleandisk code, simply send email to sunistb- 
editor. Please specify that you want the December 1989 Hackers’ Corner code. 


# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 


/bin/csh -f 

cleandisk - script that displays name and size of extraneous files while it 
removes them 
Bill Petro - 8/89 


This script removes extraneous files including: 

"bak" files 
"dot" bak files 
checkpoint files 
emacs work files 
textedit backup files 
object files 
shar files 

"script" output files 
core dumps (usually large) 


*.bak, *.BAK 

.??*.bak 

*.CKP' 

#* 

*% 

* .o 

*.shar 

typescript 

core 


nice find -- ' ( ' -name cpre -o -name \ 

'*.bak' -o -name \ 

'*.BAK' -o -name \ 

'.??*.bak' -o -name \ 

'*.CKP' -o -name \ 

'#*' -o -name \ 

'*%' -o -name \ 

'*.o' -o -name \ 

'*.shar' -o -name \ 

'typescript' -o -name \ 
core ')' \ 

•user $USER -type f -exec Is -s {} \; -exec \rm '{}' \; 
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Software Release Levels 



As of October 27,1989 
Operating Systems 


Product Name 

Current Release 

SunOS 

4.0.3 

SunOS SPARCstation 1 

4.0.3c 

SunOS 386/ 

4.0.2 
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Communications Products 


Product Name 

Current Release 

SunLink BSe3270 (SunOS 3.x) 

3.0 

SunLink BSC3270 (SunOS 4.x) 

6.1 

SunLink SCP 

6.0 

SuijLink TEIOO 

6.0 

SunLink BSCRJE 

6.0 

SunLink Local 3270 

6.1 

SunLink SNA3270 

6.1 

SunLink Peer-to-Peer 

6.0 

SunLink IR 

6.0 

SunLink DON 

5.0 

SunLink DNI 

6.0 

SunLink OSI 

6.0 

SunLink MCP 

6.0 

SunLink X.25 

6.0 

SunLink Channel Adapter SCA 

6.0 

SunLink CG3270 

6.0 

SunLink MHS 

6.0 

SunLink HSI 

6.0 

Notes: 


SunLink release 5.x products are only compatible with SunOS release 3.x. 

SunLink release 6.x products are only compatible with SunOS release 4.x. 
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Unbundled Languages 


Product Name 

Current Release 

Sun C++ (Sun-3,4 and SunOS 4.x) 

2.0 

Sun Modula-2 (Sun-2,3 and SunOS 3.x) 

2.0 

Sun Modula-2 (Sun-3,4,386/ and SunOS 4.x) 

2.1 

Sun FORTRAN* (Sun-2,3) 

1.0 

Sun FORTRAN* (Sun-4 and Sys4-3.2) 

1.05 

Sun FORTRAN* (Sun-2 and SunOS 4.0) 

1.1 

Sun FORTRAN* (Sun 386/ and SunOS 4.0) 

I.IR 

Sun FORTRAN* (Sun-3,4 and SunOS 4.0) 

1.2 

SPE for SCLisp 2.1 

1.0 

Sun Common Lisp-E 

1.1 

Sun Common Lisp-D 

2.1 

Sun Common Lisp-D (Sun-3, Sun-4)** 

3.0 

Cross Compilers (Sun-2,3,4 and SunOS 3.x,Sys4-3.2) 

2.0 

Cross Compilers (SunOS 4.x, Sun-3,4***) 

3.0 

Pascal**** (Sun-4 and Sys4-3.2) 

1.05 

Pascal**** (Sun-2,3,4,386/ and SunOS 4.0) 

1.1 

Notes: 


* The f 7 7 compiler is automatically included with SunOS Release 3.x, which 
includes SunOS Releases 3.2, 3.4, and 3.5. Sun FORTRAN 1.0 (for Sun-2,3 systems 
and SunOS 3.x), Sun FORTRAN 1.05 (for Sun-4 systems running Sys4-3.2), Sun 
FORTRAN 1.1 (for Sun-2,Sun386/ systems and SunOS 4.0), and SunFORTRAN 1.2 
(for Sun-3,4 and SunOS 4.0) are value-added products that support VMS extensions 
to the f 7 7 compiler, and must be purchased separately from the SunOS. 

There is no bundled FORTRAN or Pascal for Sys4-3.2 or SunOS 4.x. 

** Sun Common Lisp-D release 3.0 does not obsolete Sun Common Lisp release 2.1 
at this time. 

*** Runs on Sun-3,4 and produces ou^ut that also runs on Sun386/. 

**** The pc (Pascal) compiler is automatically included with SunOs Release 3.x, 
which includes Release 3.2, 3.4, and 3.5. Sun Pascal 1.05 (for Sun-4 systems) 
and Sun Pascal 1.1 (for Sun-2, Sun-3, Sun-4 and Sun386/ 

systems running SunOS 4.0) are value-added products that support many extensions 
to the pc compiler, and must be purchased separately from the SunOS. 
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Unbundled Graphics 


Product Name 

Current Release 

SunGKS 

3.0 

SunPHIGS 

1.1 

Sun58TE 

1.0 


Unbundled Applications 


Product Name 

Current Release 

SunSimplify 

1.1 

SunTrac (Sun-2) 

1.2 

SunTrac (Sun-3,4,3860 

1.3 

SunIPC 

1.1 

Transcript 

2.1 

SunUNlFY 

3.0 

PC-NFS 

3.0 

SunAlis 

2.1 

SunINGRES (Sun-2 and Sun-3) 

5.1 


Other Products 


Product Name 

Current Release 

News 

1.1 

NSE 

1.1 


TOPS Network Products 


Product Name 

Current Release 

TOPS for the PC 

2.1 

TOPS for the Sun Workstation (Sun-3, SunOS 3.5) 

2.1 

TOPS for the Sun Workstation (Sun-3, Sun-4, Sun386i, SunOS 4.X) 

2.2 

TOPS for the Macintosh 

2.1 

TOPSNetPrint 



Current Sun Software The preceding tables contain lists of current Sun software products and their 

Products and Release Levels respective current release levels. 

You will note that the Software Technical Bulletin (STB) contains articles from 
time to time that detail technical changes in a given software product’s next 
available release. 
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Please contact your sales representative if you decide that you would like to 
update the release level of a Sun software product you already use, or wish to 
purchase another product. Use the tables to determine whether your release is the 
current release level. 

These tables appear monthly in the STB for your convenience. 
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c partition 

whole-disk convention, 912 
c2 

SunOS 4.0 security, 768 
c2conv 

SunOS 4.0 security, 769 
cabling 
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and device drivers, 55 
flushing, 51 
MC68020 on-chip, 42 
overview, 44 

performance and moving data, 63 
Sun-3/200 and Sun-4/200,42 
tags, 50 
variations, 43 
virtual addlress, 46 
caching 

PC-NFS 3.0 XBD, 417 
calendar 

4.0 network traffic, 1411 
call mapping 

SunCGI-SunGKS, 1179 
case study 

SDRWAVE,685 

century 

SunUNIFY 3.0 dates, 419 

cg6 

demonstration programs, 953 
cgfour 

moving windows hint, 1343 
checkconfig 

problems rebooting, 1056 
checkmail 

Hackers’ Corner, 1083 
checksum 

Ethernet, 24 
child processes 

debugging with dbx, 643 
classes 

network addressing, 650 
client side 

NFS in depth, 924 
client-server model 
Sun386/, 79 
clients 

diskless booting troubleshooting, 1413 
cmdtool 

disappearing on 3/50s, 1059 
dying due to signal 1,1059 
error messages and bugs, 1494 

code 

tuning hints, 461 
colormaps 


colormaps, continued 
bug 1007283, 367 
flashing, 648 
managing, 367 
compatibility 

Consulting Specials, 354,1225 
compilers 

cross 3.0 announcement, 1285 
configuration 
Sun386/, 984 
Configuration Guide 
Sun386/, 984 
configurations 

4.1 kernels, 1049 
SCSI devices, 1037 
SPARCserver 330 cable lengths, 1043 
SPARCserver 330 SCSI devices, 1042 
SPARCstation 1 cable lengths, 1041 
SPARCstation 1 SCSI devices, 1040 
Sun-3/80 cable lengths, 1039 
Sun-3/80 SCSI devices, 1038 
CONSULT-PROXYARP 

and Sys4-3.2 subnetting, 521 
Consulting 

available Specials, 354,1225 
available Sun specials, 354,1225 
Sun Germany u u c i c o special, 259 
controllers 

SMD-4,258 
conventions 

SunOS 4.1 naming, 1045 
conversion 

Sun-to-IBM FP, 469 
conversions 

Sun View 1 to View2 programs, 425 
coordinates 

SunGKS 3.0,1177 
courses 

from Sun Educational Services, 349 
cross compilers 

3.0 announcement, 1285 
cross-referencing 

Hackers’ Corner, 1203 
CSD Europe 

reporting bugs, 229,339,495,621,740, 879,1008,1132, 
1262, 1401 

cursors 

colormap flashing, 648 
cylinder groups 

increasing inodes, 1019 

D 

daemons 

4.0.3 syslogd initialization, 1281 
printer, 361 

troubleshooting printer, 569 
data alignment 

porting C to SPARC, 266 
data structures 

SCSI device drivers, 791 
database 

bugs onUne, 228,338,494, 620,739, 878,1007,1131,1261, 
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1400 

database, continued 
databases 

distributed, 1055 
datagrams 

fragmentation of, 37 
reassembly of, 37 
dates 

SunUNIFY 3.0 and beyond 2000,419 

dbx 

debugging child processes, 643 
hints and tips, 703 
dbxtool 

hints and tips, 703 
DC 

SunGKS 3.0,1177 
de-support 

Sun-2 languages, 415 
debuggers 

kernel, 246 
debugging 

dbx and child processes, 643 
floating point exceptions, 1484 
demonstration programs 
cg6,953 
demos 

cg6,953 
demultiplexing 
TCP/IP, 21 
dependencies 

software and hardware, 1363 
dependency tables, 505 
errata, 1015 
device coordinates 
SunGKS 3.0,1177 
device drivers 

4.0.3 SCSI device driver data structures, 791 
4.0.3 SCSI high-level driver theory, 821 
4.0.3 SCSI high-low interface, 801 
4.0.3 SCSI interface example, 811 
4.0.3 SCSI low-high interface, 807 
4.0.3 SCSI specification, 791 
and cache, 55 

and kernel architectures, 758 
Sun386/ ATbus, 510 
dialing 

Sun386i and modems, 1033 
differential 

SCSI transmission, 1233 
direct memory access 

Sun386i ATbus drivers, 513 
disk space 

saving script, 1505 
diskettes 

used as filesystem tip, 948 
diskless clients 

booting troubleshooting, 1413 

disks 

688MByte, 258 

saving space in Hackers’ Corner, 1433 
distributed databases, 1055 


divide-by-zero 

finding using dbx, 947 

DIX 

and Sun386/ Ethernet pinouts, 1441 
DMA 

Sun386/ ATbus drivers, 513 
DMA channels 

Sun386/ ATbus, 510 
domain system 
Internet, 31 
domains 

multiple YP, 519 
domestic kit 

SunOS 386i 4.0.1,635 

DOS 

enscript hints, 1345 
expanded memory tip, 1429 
maximum open files, 257 
Windows 1.0 announcement, 1156 
DOS Windows 

1.0 announcement, 1156 
drivers 

Sun386i ATbus, 510 
dtree 

displaying file trees, 260 

E 

education 

available Sun Courses, 349 
catalog, 778 
email 

checkmail Hackers’ Corner, 1083 
mush in Hackers’ Corner, 1349 

reporting bugs in CSD Europe, 229,339,495,621,740,879, 
1008, 1132,1262,1401 

reporting bugs in Intercon, 233,343,499,625,744, 883, 
1012, 1136,1266, 1405 

reporting bugs in the US, 227,337,493,619, 738, 877,1006, 
1130, 1260,1399 

end of life 

SunCGI and SunOS 4.1,564 
SunCORE and SunOS 4.1,564 
end-of-life plan 

Sun-2 languages, 415 
enscript 
hints, 1345 

environment variables 

Sun View windows, 1170 

EPS 

and SunWrite, 631 
errata, 1139 

dependency tables, 1015 
XView, 679 
error logging, 776 
error messages 

cmdtool, 1494 
Ethernet, 84 
graphics, 785,786,787 
ioctl, 787 
printcap tips, 1077 
errors 

Ethernet table, 90 
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errors, continued 

ioctl #1C, 1053 
NFS write 13,559 
es_f ile_read error 
f seek, 1058 
ESDI shoebox 

ordering information, 1099 
Ethernet, 24 

buffer management, 86 
error messages, 84 
error table, 90 
header, 24 
ethemet 

maximum interfaces, 256 
Ethemet 

memory management, 89 
panics, 90 
Sun-3 hiirdware, 84 
Sun386/ pinouts, 1441 
Ethemet addresses 

Hackers’ Comer, 109 
expansion 

DOS expansion tip, 1429 
External Data Representation 
NFS in depth, 919 

F 

FCBs, 257 
features 

4.0.3 summary, 897 
fhandle 

NFS in depth, 921 
file control blocks, 257 
file handles 

DOS maximum, 257 
NFS in depth, 921 
file locking 

NFS in depth, 931 
file translation 
TOPS, 74 
file trees 

displaying, 260 

files 

maximum DOS open, 257 
filesystems 

kernel architectures, 755 
netgroups and NFS access, 1279 
on diskettes tip, 948 
find 

displaying file trees, 260 
flashing 

colormaps, 648 
floating point 

exception debugging, 1484 
hardware testing, 1490 
IEEE and Sun FORTRAN, 1473 
Sun-to-IBM conversion, 469 
floppy 

Sun386i format, 911 
floppy diskettes 

creating Sun386i UNIX filesystems, 420 
flushing 


flushing, continued 
cache, 51 
fonts 

error when missing, 1053 
LaserWriter n, 369 
format 

Sun386/ floppy disks, 911 
FORTRAN 

cross-referencing in Hackers’ Comer, 1203 
dbx debugging hints, 703 
finding zero-divides, 947 
optimizing examples, 1199 
porting hints, 291 
SDRWAVE benchmark, 685 
short warning message, 563 
Sun and IEEE floating point, 1473 
SunFORTRAN 1.2 announcement, 655 
undefined units, 1058 
FP 

Sun-to-IBM conversion, 469 
FPU2 

and SunFORTRAN 1.2, 655 
hardware and software support, 852 
fragmentation 
datagrams, 37 
FreeSpace 

saving disk space in Hackers’ Corner, 1433 
f sek inconsistencies, 1501 
f seek 

esfileread error, 1058 
FTP, 14 

function return values 

porting C to SPARC, 273 

G 

gateways, 34 

TOPS and PC-NFS, 241 
Germany 

uucico Consulting special, 259 
graphics 

error messages, 785,786,787 
ioctl error message, 787 
groups 

increasing inodes, 1019 
network filesystems, 891 
YP,891 

H 

Hacker’s Comer 

super kill skill, 299 
Hackers’ Corner 

checkmail, 1083 
Ethemet addresses, 109 
locate script, 713 
tar -i, 837 
handles 

file, 257 
hardware 

and software dependencies, 1363 
dependency tables, 505 
Ethernet, 84 
questionnaire, 849 
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hardware, continued 

Sun386/ parallel port pins, 851 
testing floating point, 1490 
Hardware Technical Bulletin 
hardware interest, 849 
headers 
IP, 23 
octets, 19 
overview, 21 
Hints and Tips 

modem installation, 95 
modem problems, 100 
terminal installation, 95 
hotline@sun,COM 

reporting bugs, 221, 337,493,619,738,877,1006, 1130, 
1260,1399 

hotlines 

world, 225, 335,491, 617, 736, 875, 1004,1128,1258,1397 

HTB 

hardware interest, 849 

I 

ffiM 

FP conversion to Sun, 469 
IBM PC 

TOPS, 68 
ICMP, 30 
IEEE 

754 standard, 1473 
floating point numbers, 1475 
warning messages, 1483 
IEEE 302.3 

and Sun386/ Ethernet pinouts, 1441 
IEEE floating point 

and Sun FORTRAN, 1473 
ilpr 

Interleaf to PostScript files, 915 
implementation architectures 
SunOS 4.1,1047 
INGRES 

support transition, 561 
inodes 

maximum using mkf s, 1019 
inputs 

Sun-CGI-SunGKS, 1191 
installation 

Sun386/ SunOS 4.0.1 remotely, 1021 
installations 

tapeless, 949 
Intercon 

hothne, 226,336, 492,618, 737, 876, 1005,1129, 1259, 1398 
reporting bugs, 233, 343,499, 625,744,883,1012, 1136, 
1266, 1405 

interface 

4.0.3 SCSI example, 811 
4.0.3 SCSI high-level driver theory, 821 
4.0.3 SCSI high-low, 801 
4.0.3 SCSI low-high, 807 
interfaces 

ethemet maximum, 256 
Interleaf 

to PostScript files, 915 


Internet 

addresses, 35 
domain system, 31 
protocols, 13 
Internet Protocol 

NFS in depth, 921 
subnetting, 650 
interrupt channels 

Sun386i ATbus, 510 
ioctl 

#1C errors, 1053 
error messages, 787 
IP, 13 

headers, 23 
NFS in depth, 921 
subnetting, 650 
ISO 

NFS in depth, 921 

K 

kernel 

architectures, 750 

architectures and kernel-level applications, 753 
debuggers, 246 
kernel architectures, 751 
archd), 752 
device drivers, 758 
filesystem layouts, 755 
kernel-level applications, 753 
small kernels, 764 
sun3*, 750 
sun4*, 750 
visibility, 753 
kernel configurations 
SunOS 4.1,1049 
kernels 

small pre-configured, 764 
SunOS 4.0 profiling procedure, 583 
keyboards 

type 4 dip switches, 1234 
kill(l) 

Hacker’s Comer, 299 
kit 

SunOS 386/ 4.0.1 domestic, 635 

L 

languages 

Sun-2 de-support, 415 
LANs 

and the Sun386/, 1104 
LaserJet II 

on Sun386/ parallel ports, 653 
LaserWriter II 
fonts, 369 
LaserWriters 

troubleshooting, 569 
layering 

mail, 19 
left shifting 

text edit bug, 1060 

lex 
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line discipline 

changing characteristics, 645 
lint 

use during porting, 265 

Lisp 

new products, 895 
locate 

Hackers’ Comer script, 713 
locking files 

NFS in depth, 931 
lockscreen 

C2 and SunOS 4.0,526 
log 

errors, 776 
logging 

4.0.3 system daemon, 1281 
login 

Sun386/ security fix, 783 
logintool 

Sun386i security fix, 783 
loopback packets 
Sun386i, 893 

Ipc 

aborting printing daemon, 361 
unreliable daemon killing, 574 

Ipd 

troubleshooting, 569 

Ipq 

hints and tips, 1077 

Ipr 

hints and tips, 1077 
Is 

displaying file trees, 260 

M 

machdep.c 

SunOS 4.0.3 fix, 1286 
Macintosh 
TOPS, 66 
mail, 15 

layering, 19 

mush in Hackers’ Corner, 1349 
routing, 33 
manual pages 

printing using troff, 418 
mapping 

SunCGI-SunGKS calls, 1179 
maps 

customizeid YP, 516 
mass storage subsystems 

ordering information, 1099 
master 

Sun386/ YP hints, 1501 
MC68020 

on-chip cache, 42 
memory 

DOS expanded tip, 1429 
textedit window maximum, 1171 
memory buffer 

error message, 787 
memory management 


memory management, continued 
Ethernet messages, 89 
messages 

cmdtool, 1494 
IEEE warnings, 1483 
valloc failed, 1420 
Micom-Interlan 5210 
driver upgrade, 416 
mkf s 

maximum inodes per group, 1019 
Sun386i UNIX filesystems, 420 
mmap(2) 

uses, 1493 
modems 

Hints and Tips, 100 
install Hints and Tips, 95 
null-modem cabling, 1095 
SPARCstation 1,1061 
Sun386i serial cards, 1033 
monitors 

base size ordering, 1098 
corrupted Sun386i vi displays, 1197 
Sun386/, 984 
MS-DOS 

address space emulation, 510 
communications software, 1035 
Sun386/ and modems, 1035 
multicast packets 
Sun386/, 893 
mush 

Hackers’ Corner, 1349 

N 

name servers, 1153 
naming 

4.1 conventions, 1045 
NDC 

SunGKS3.0,1177 
netgroups 

NFS file system access, 1279 
netmasks 

default, 650 
subnetting, 650 
network 

address classes, 650 
Network File System 
client side, 924 
file locking, 931 
filesystem naming, 930 
implementation, 928 
in depth, 919 
overall design goals, 920 
porting experience, 936 
security, 931 
server side, 923 
the protocol, 921 
time skew, 932 
versus RFS, 934 
network window systems 
Sun386i, 81 
networks 

4.0 calendar traffic, 1411 
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networks, continued 

filesystem groups, 891 
Sun386/, 77 
Sun386/ windows, 81 
News 1.1 

errata to RTF, 236 
NFS, 16 

client side, 924 
file locking, 931 
filesystem naming, 930 
implementation, 928 
in depth, 919 

netgroups and file system access, 1279 
overall design goals, 920 
porting experience, 936 
security, 931 
server side, 923 
Sun386/, 78 
the protocol, 921 
time skew, 932 
versus RFS, 934 
write error 13,559 
normalized device coordinates 
SunGKS 3.0,1177 

o 

OBD, 227,337,493,619,738, 877,1006,1130,1260, 1399 
change notes, 1271 
Sun386/ bugs added, 253 
octets 

TCP/EP headers, 19 
ONC 

Sun386/, 77 
online 

bugs database, 228,338,494, 620,739,878,1007,1131, 
1261, 1400 

Online Bugs Database 
change notes, 1271 
Sun386/ bugs added, 253 
OPEN LOOK 

ordering information, 1101 
STAGE products, 530 
OpenWindows 

moving windows hint, 1343 
optimizing 

FORTRAN examples, 1199 
output primitives 

SunCGI-SunGKS, 1181 
overviews 

Sun386j on networks, 77 

P 

packets, 24 

PC-NFS 3.0 trailers, 255 
padding 

porting C to SPARC, 270 
panics 

Ethernet errors, 90 
parallel port 

Sun386/ AT compatibility, 1358 
Sun386i signals, 851 
parallel ports 


parallel ports, continued 

LaserJet IT on Sun386i parallel ports, 653 
parameters 

passing with SPARC, 275 
partitions 

whole-disk c convention, 912 
passing parameters 

porting C to SPARC, 275 
PC 

TOPS, 68 
PC LANs 
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